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D I SCl_*~> T MER 

Alpha Logic Business Systems, Inc. reserves the right to make improvements 
in the product described in this manual at any time and without notice. 

Alpha Logic Business Systems, Inc. and the authors make no warranties, 
either express or implied, with respect to this manual or with respect to 
the software described in this manual, its quality, performance, 
merchantability, or -fitness -for any particular purpose. This software is 
sold or licensed "as is". The entire risk as to its quality and 
performance is with the buyer. Should the programs prove defective 
following their purchase, the buyer (and not Alpha Logic, the author, 
their distributors, or their retailers) assumes the entire cost of all 
necessary servicing, repair, or correction and any incidental or 
consequential damages. In no event will Alpha Logic or the author be 
liable for direct, indirect, incidental, or consequential damages 
resulting from any defect in the software, even if they have been advised 
of the possibility of such damages. Some states do not allow the 
exclusion or limitation of implied warranties or liability for incidental 
or consequential damages, so the above limitation or exclusion may not 
apply to you. 

NOTICE OE COPYRIGHT 

This manual is copyrighted. All rights are reserved. This document may 
not, in whole or in part, be copied, photocopied, reproduced, translated 
or reduced to any electronic medium or machine readable form without prior 
consent, in writing, from Alpha Logic Business Systems, Inc. 

This software is a fully copyrighted work and as such is protected under 
the copyright laws of the United States of America. According to these 
laws, consumers of copywritten material may make copies for their personal 
use only. Duplication for any other purposes whatsoever would constitute 
infringement of copyright. 

Copyright 1980-1987 by: 
Alpha Logic Business Systems, Inc. 
163 Chicago Street 
Cary. Illinois 60013 

The word LOCKSMITH and the Locksmith logo are registered trademarks of 
Progressive Business Systems, Inc. 

H«RDW<=»RE REQUIREMENTS 

Apple II, Apple II Plus, Apple //e, Apple //c, or compatible computer. 
48K required. One or two disk drives. 

Optional hardware supported: 16K, 32K, 64K, 12BK, 256K slot RAM boards or 
auxiliary memory boards; optional printer. 

Lorksmith 6.0 - manual revision: 6.0.00 
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I NTRDDUCTION 

THE COPYRIGHT LAW ALLOWS THE CREATION OF ARCHIVAL COPIES OF COMPUTER 
SOFTWARE WHICH IS OWNED BY THE LOCKSMITH USER. LOCKSMITH IS SOLD WITH THE 
UNDERSTANDING THAT THE PURCHASER WILL NOT USE THE PROGRAM TO GENERATE 
DISKS OF COPYRIGHTED PROGRAMS FOR SALE OR DISTRIBUTION. 



#=*BOU~T YOUR NETIaJ l—OOKSM I T*M £> _ O 

Locksmith was first released in December, 1980. It was the -first bit-copy 
(or mbbl e-copy ) program available for the Appl e. Since that ti me, 
Locksmith has evolved from a bit-copy program into a powerful disk and 
memory utility. 

Whi 1 e other bi t-copi ers made mi nor enhancements and charged update fees 
for the "new" software, Locksmith users have been able to install 
enhancements to their own copi es of Locksmi th by appl ying patches whi ch 
are suppl led free of charge. 

As new enhancements to Locksmith become available in the form of updates, 
user applied patches, and new parameter disks, registered users Are 
notified by mail or the Locksmith newsletter. If you have not already 
done so, be sure to compl ete the regi strati on card i ncl uded with your 
Locksmi th. 

Loc ksmi th programmi ng 1 anguage (LPL) has been greatly i mproved. Many 
users found the LPL section in the version 5.0 manual to be difficult to 
read. A large part of this manual is dedicated to explaining the details 
of LPL , using many ex ampl es. Whi lea great deal of effort has been made 
to keep LPL in version 6.0 compatible with LPL in version 5.0, the code 
l tsel f has been compl etel y rewr l tten , and 1 anguage def i ni 1 1 ons have been 
ex tended to all ow for easy future ex pans i on. Al most all Locksmi th 
functions can now be invoked from LPL (including Fast Disk Backup and 
sector ed i t i ng ) . 

The Locksmi th phi 1 osophy has al ways been to all ow the user to backup his 
software, but not to promote software pi racy i n any way. Locksmi th al ways 
made an i dent i cal copy of the or iginal diskette, including 

copy-protect i on , copyr i ght not l ces, and ser i al numbers. The copy made by 
Locksmi th was , like the or iginal diskette, copy— protected . New protect i on 
techniques were i ntroduced and Locksmi th handl ed them. However , recent 1 y 
some manuf ac turers have i ntroduced copy protect l on techni ques whi ch ar& 
based on the fact that special hardware can create a special "signature" 
whi ch can be read by a standard Appl e disk dri ve, but not rewr i tten. 
Because of the introduction of these truly uncopyable diskettes, we have 
found i t necessary to all ow the user to "unprotect " or "break " the 
software in order to make a backup. It is i mportant to understand that by 
provi di ng tool s to all ow the user to remove the copy protect i on , that we 
in no way condone or promote software piracy. We will not knowingly 
accept or publish parameters whi ch remove copyr i ght not i ces, serial 
numbers , or other i dent i f yi ng i n format i on al ong with the copy protect i on. 
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Locksmith 6.0 has many completely new functions, including! 

Automatic Boot Tracer 

Sector and Track Edi tor 

Sector Edi tor for Protected di skettes 

RAM Card Utilities including RAMtest. 

Advanced Disk Recovery: 

Data written off-center 

Data wr 1 tten on mi sal i gned drive 

Partially overwritten sectors 

DOS Fi le Util lties: 

Alphabetize CATALOG 

Un-Delete a file 

Remove DOS from diskette 

Fix sector counts 

Verify VTOC and fix errors 

Di sk space map 

File Edi tor 

Encrypt /Decrypt a file 

BACKINB LJF* YOLJFi: LOCKSMITH DISK 

Your Locksmi th 6.0 disk and the 1 nc 1 uded parameter di skette (parmdi sk ) are 
not copy-protected . You shoul d i mmedi ately make a bac kup copy of your 
original diskettes using the FAST DISK BACKUP function of the main menu 
and place the or i ginals in a safe pi ace. You may need the or l gi nal 
Locksmith diskette for program updates, as they Are made available. 
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THE HI I STORM OR" LOCK SMI TM 

^injo copy f>f*ote:c:t~ i oisj 

For the past several years, there has been an intense battle being fought 
between software manufacturers and software users. The manufacturers, 
concerned about their programs being pirated or stolen, started 
•protecting' their software. They did this by making their programs 
uncopyable. This means that normal copy programs would no longer copy 
their software. Since it could not be copied, it could not be passed 
around between users. This was to insure that anyone who wished to use a 
program would be required to purchase it, thereby guaranteeing that the 
manufacturer would receive his fair share of profits. 

As in most issues, however, there are two sides. Software users, upon 
purchasing a program, received a disk which they could not copy. This 
means that they could not even make back-ups of their disks, which is a 
1 egi 1 1 mate concern of everyone who has ' bl own ' a disk. Si nee some 
businesses day to day operations rely very heavily on their software 
investment, this becomes a very critical situation. Some applications 
simply do not allow for up to several weeks waiting time while the bad 
disk is sent out to be replaced- In addition, some of the manufacturers 
charge inflated prices to get these replacements. It seems rather unfair 
to charge S35.00 for a replacement of a «2.0O disk for which the user 
already paid *250.OO to purchase. 

Short 1 y after these 'protected' di sks started appearing on the market. 
Locksmith was made available to copy these disks. Locksmith used a new 
type of technology to copy protected software, known as nibble-copying. 
In the several years since, the manufacturers have introduced new, more 
sophisticated methods of copy protection. As a result, Locksmith has been 
updated several times to anticipate new methods of protection. 

In this section, we will discuss the origin of Locksmith, and some of the 
different methods that have been used for protection over the past several 
years. 

The original Locksmith program was written in 1979 by an Apple programmer 
with 18 years of computer experience, including systems programming on 
1 arge I BM mai nf r ames at several 1 arge cor porat i ons. His l nterest l n 
computers dates back to grammar school , when he woul d spend his Saturdays 
taking computer courses at the IIT computat ion center in Chi cago. 

The first version of Locksmith, which was never released, was a primitive 
ni bbl e copy program known as ' NI BY' . It was wr i tten as an educat l onal 
excerci se — "because i t was a chal 1 enge" . When i t was shown to some of 
his c 1 ose f r i ends from the 1 ocal Appl e users group , i t gathered much 
interest, and because no program like it was aval 1 abl e, several Appl e 
users suggested that the program might be marketable. 

In December 1980, Locksmith version 2.0 was released. It was the first 
program ever introduced to allow the Apple user to backup his 
copy-protected software. 

Like any tool in the wrong hands, it was feared that Locksmith might be 
used for tasks it was not intended to perform — PIRATING. Because of 
this fear , each Locksmi th was uni quel y ser i al numbered and regi stered, and 
every copy of Locksmith also placed this unique serial number on EVERY 
disk that it copied. This fact, by the way, was never made known until 
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Encoding the Locksmith serial number on the copied disk provided the 
distributor with the capability of identifying the owner of any Locksmith 
used for pirating any manufacturers software, and the distributor offered 
to assist software manufacturers in the prosecution of software pirates. 
No software manufacturer however, has ever requested this assistance. 
Placing the Locksmith serial number in an inconspicuous place on ev»ry 
disk that is copi ed i s not an easy task . In fact , this practice has 
caused several probl ems with copy i ng some disks in early ( versi on 4 > 
rel eases of Locksmi th . Because of this, Locksmi th , begi nni ng with versi on 
5.0 no longer encoded its serial number on the copy disk. 

Locksmith has evolved from version 1.0 (the unreleased 'NIBY'), to 
versions 2.0, 2.1, 2.2, 3.0, 3.1, 4.0, 4.1, 4.1a, 5.0, 5.1, and now 6.0. 
No longer the work of a single programmer, Locksmith 6.0 is now maintained 
by a team of Appl e copy-protect i on experts. 

No 1 onger just a nibbl e-copi er , Locksmi th is now a full -feat ured ut l 1 i ty 
and di agnost l c tool for the Appl e II computer . Al ways searchi ng for 
i mprovements, Al pha Logi c wel comes suggest! ons, comments, and any 
questions you may have about Locksmith. 

We will now discuss some of the different methods that have been used for 
protection over the past several years. Some of the descriptions are of a 
technical nature, and are intended for the more advanced user. 

The very first types of copy protect l on to appear were very si mpl e in 
nature. The f l rst protected disks used nothing more compl i cated than 
er asi ng an unused track on the disk. Thi s was usual ly track 3. Thi s 
method is not very compl l cated , but initially it was quite effective. All 
of the copy programs at that time copied the disk one track at a time. 
When it tried to read the erased track, it would get an 1/0 error, causing 
the copy program to stop. By doing this, none of the tracks beyond the 
erased track would copy. 

Some of the copy programs that came out a little later woul d copy onl y 
those sectors that were marked on the catalog track (track *11) as being 
used. This got past the erased track problem. To combat those copy 
programs, companies started to move the catalog to a different track. 
When the copy program went out to track *11 to read the information, the 
information would not be there. This also prevented a normal Disk 
Operating System (DOS) from reading and writing to the protected disk. 

Shortly after that time, a new method was introduced. It was a little 
known fact that while the disk normal ly used only tracks *00-*22, it was 
actually capable of reaching track *23. Some of the software began using 
this track for program information. All copy programs at that time were 
incapable of copying track »23, so that when a copy was made, some 
information was lost. This method proved to be ^/ery dangerous, because 
some disk drives could not reliably read or write to track 423. This 
means that you could not even use the original protected disk on that 
drive, since it could not read that track. 

At this point, the protection methods started to become mare 
sophisticated. State of the art had progressed to the point where the 
manufacturers were actual 1 y changing' the format of inf or mat l on on a disk . 
At first, this was done by changing the checksum for the address field on 
the disk. This would cause 1/0 errors which would halt the copy process. 
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Disks whi ch were protected by chang ing the format of i n for mat 1 on requi red 
their own Disk Oper at 1 ng System. 

At approximately the same time, some manufacturers started changing the 
format of the address field on a disk sector. Normally, the format is to 
have an address header, fall owed by i nf or mat i on concerni ng the vol ume, 
track, sector and checksum. This was followed by an address trailer. The 
order of the volume, track and sector was changed around, or put in a 
di f f erent f or mat . For ex amp 1 e, one company changed all sector numbers to 
be even numbers. Instead of sectors 0, 1, 2, 3 etc., they used numbers of 
0, 2, 4, 6 etc. Normal DOS could not understand these formats. 

The headers and trailers for both the address fields and data fields were 
changed as the next type of protection. Since DOS looks for a specific 
header or trailer to read a sector, it will never find a sector on this 
t ype of disk. On these disks, it waul d 1 mpossi ble to read any 
i n for mat i on wi th a normal DOS. 

Once agai n , an ent i rel y new technol ogy appeared for protect i on. Up unt i 1 
this 1 1 me, all l n format i on was stored on a disk in Track /Sec tor format . 
Now, tracks started to appear using pseudo-sectors. A pseudo-sector is a 
long string of data, with only a data header of some type. Some of these 
pseudo-sectors were an ent i re track in 1 ength . None of the programs for 
reading Track/Sector format could decode this type of track. With the 
advent of pseudo-sector s, nibble copy programs became necessary . Unt i 1 
this time, it was usually possible to modify normal DOS, to copy these 
disks. This was no longer possible. Shortly after pseudo-sectors 
appeared, Locksmith was first introduced. It was capable of copying 
tr ac ks which were in a non-standard format . 

Synchronized tracks were the next method of di»k protection. Synchronized 
tracks Are tracks that are wr i tten in a speci fie timing rel at i onshi p to 
each other . For ex amp 1 e, after reading track *00, the disk dri ve woul d 
then seek to track *01. Upon arriving at track *01, data would be read in 
f ram that track. The program that was boot i ng woul d 1 ook for spec i f i c 
data to be present when it arr i ved at the new track. If this data was not 
at the beginning of the track it read, it would cause the program to f ai 1 . 
Thi s meant that copy i ng tracks wi thout preservi ng this timing relati onshi p 
woul d resul t in a bad copy, even though all of the i nf or mat l on was 
transfer ed . 

Another type of protection which was concerned not only with the actual 
data that was copi ed, was nibble count i ng. After wr i ting a track when 
generat ing a disk, the track woul d be read back , and a count of the 
n i bbl es on a track woul d be stored on the disk. Upon boot i ng, the disk 
would look for the track to be that specific length. Since very few disk 
drives run at exactly the same speed, the chances were very unlikely that 
the track 1 ength woul d be the same on a copi ed disk. 

Software manufacturers next started to take advantage of a little known 
fact concerning the disk drive. While disk drives were normally used on 
tracks *00 through *22, they wtrt capable of reaching bftwttn trackm. 
This araa between tracks is known as a half-track. Due to the width of 
the read/wr i te head, it is not possible to write data on adjacent tracks 
and half tracks wi thout ex per i enc ing cross-tal k probl ems. However , it is 
possible to wr i te data on half— tracks, provi di ng that the adjacent tracks 
Are not used. It then became necessary to use copy programs that were 
capable of reaching these half-tracks. One major problem with this type 
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of protection scheme is that not all disk drives Are capable of reaching 
half-tracks. Some very popular drives can only reach integral tracks, and 
disks using this type of protection can not boot on these drives. If you 
are using Micro-sci type A40 drives with your Apple, keep in mind that 
half-tracks can not be accessed, although all other Locksmith functions 
work as documented. 

There was one type of protect i on whi ch appeared and short 1 y thereaf ter , 
d i sapp eared from the market. Thi s t ype of protect i on actual ly physically 
damaged the disk. A scratch was made on the disk with a sharp instrument. 
When booting, the disk would attempt to write and then re-read data on the 
track with the scratch. If the test passed, it meant that the disk was 
not damaged, and therefore, not an original disk. This was a very 
undesi reabl e method, since the damaged port ion of the disk woul d need to 
come in contact with the read/write head on the disk drive. When the head 
was over the damaged track, you could actually hear a 'tick-tick' as the 
scratch hit the head. This could cause damage to the head, and because of 
that, the method was quickly abandoned. 

The chief difficulty in copying protected disks was identifying which 
nibbles on a track were normal, and which nibbles were self-sync. 
Locksmith versions 2, 3, and 4 attempted to identify self-sync nibbles by 
content, that is by the surrounding nibble patterns. Up until this time, 
disks used nibbles with a value of *FF for self-sync nibbles. It was a 
fair assumption that a string of *FF nibbles represented fields of 
self-sync. To combat this, manufacturers started to use different values 
for self-sync. This made identifying self-sync nibbles more difficult. 
In some cases, mul tiple nibbl es were used , for ex ampl e *D5 *AB *D5 *AB, 
etc. Because Locksmith identified self-sync nibbles contextual ly, 
parameter changes were requi red for copyi ng disks of this type with 
Locksmi th ver si ons 4. 1 and earl i er . 

One very sophisticated method of protection appeared on the market shortly 
thereafter. This method required that specific nibbles in the middle of 
normal data be spec i al sel f -sync ni bbl es. By using timing rout i nes , it 
was possible to deter mi ne if this nibble was normal , or spec lal. This 
special nibble is called a data-latched nibble. When reading a track of 
nibbles normally, the data-latched nibble was indistinguishable from a 
normal nibble. Copying these tracks was very difficult, since it required 
actually breaking or deciphering the code to determine which nibbles had 
to be data-latched. This method was very effective, and has been in use 
for quite a while. Locksmith 5.0 was capable of determining self sync 
nibbles while reading them without regard to context nibbles, and it was 
able to detect data-latched nibbles without any user-supplied parameters. 

As mentioned before, it is not possible to write adjacent tracks and 
half-tracks. This is due to the fact that the read/write head is wide 
enough to overlap onto the adjacent track or half-track, effectively 
erasing information. To alleviate this problem, the concept of spiral 
tracks was invented. This is simply writing approximately 1/3 of a track, 
jump out a half track, write another 1/3 of a track, etc. By using this 
method, adjacent tracks and half-tracks may be used without actually 
writing any data closer than one full track apart. The data on the disk 
actually seems to spiral in toward the center of the disk, hence the name 
' sp i r al track ' . 

The most recent type of protection is much the same as half-tracks. It is 
the use Df quarter tracks. While it is true that the disk drive is not 
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normally capable of reaching quarter tracks, it is possible to drive the 
stepper mot or on the drive so that it will stop on the quarter track . 
Thi s requi res some very special timing rout i nes. It works basically the 
same as half-tracks, and the same restrictions about adjacent data apply. 

Locksmith 6.0 is capable of handling all of these types of protection 
methods, along with many others. Due to its extreme flexibility, it will 
also support many protection methods which have not yet appeared. 

I f , whi le using Locksmith, you find a particularly useful suggest ion or 
technique that you would like to see included in a future release of 
Lock smith, please 1 et us know. 
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COMMON L-OCKSMITM CONTROL KEYS 

Three keystrokes listed In the Locksmith main menu can ba typad at any 
time, whether in tha main manu or not. These keys ara [control -Z 1 , tESCl, 
and the [RESET1 kay. 

Ccontrol-Z] 

Pressing 'CTRL-Z' at any tima will print tha taut scrun to a printer. 
Tha printar should ba turned on and enabled. Locksmith assume* that tha 
printer interface is installed in Slot 1, but may be changed to any slot 
by changing the parameter name 'PRT.SLOT*. 

CESC1 

The ESC key may be pressed at any time to abort a function, and place you 
in an earlier menu. Pressing this key will eventually bring you back to 
the Locksmith main menu. 

[RESET! 

To exit Locksmith and re-boot your system, press the RESET key while 
holding down the CTRL key. 

IMPORTftNT LOCKSMITH INFORMATION 

When the prompt 'PRESS SPACE TO CONTINUE' appears in flashing characters 
at the bottom of the screen, you may press tha space bar to continue, or 
press tha ESC kay to abort the function. 

The entire Locksmith program is too large to fit in the memory of your 
Apple at one time. It is loaded from disk into memory in sections called 
"overlays". It is important to keep your Locksmith disk in the boot drive 
until instructed to insert other disks to process. If an overlay is 
required to be loaded, and the Locksmith diskette is not inserted, you 
will be prompted to re-insert the Locksmith disk. 

when a Locksmith function is invoked which requires you to insert 
diskettes either for input or output, you will be prompted to insert them 
before the function begins processing.' Signal that the diskettes have 
been inserted by pressing the space bar. If at any time you wish to 
cancel or abort a function, press the ESC key. 



THE TRACK STATUS D I SPLA "V 

The top 7 lines of tha Locksmith screen are reserved for the track status 
di splay. 

This display shows the status of the last operation on each track of the 
diskette. Tracks are numbered from 00 to 22 (in hexadecimal, which is 
to 34 in decimal). A position for track 23 is provided because some early 
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protection techniques made use o-f this accessable but normally unused 
track. . 

Although most Apple software only uses integer tracks from 00 to 22, the 
Apple dlst drive is actually capable of moving the head between tracks. 
For this reason, four lines are provided for each numbered track. The 
topmost of these four lines contains the status codes for integer track 
numbers such as 00, 01, 02, etc. The other 3 of the 4 lines contain track 
status codes for 1/4 tracks, half-tracks, and 3/4 tracks, respectively. 

Shown below is an example track status display. 

THE LOCKSMITH - VERSION 6.0 - REVISION A 

.00 o 

.25 

.50 4 

.75 5 

HE X 0000000000000000 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 2222 

TRK 1 23456789ABCDEF0 1 23456789ABCDEF0 1 23 



The example shows status code for track OA, status code 4 for track 
13.5, and status code 5 for track IB. 75. 

Status codes are dependent on the individual Locksmith function currently 
running, and are described separately. 
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CBETT-rilMtB STARTED: 
&£*Ct< I IM<3 UP A D I SK 

There are several functions within Locksmith which are capable of back mg 
up a diskette. Which one you will want to use depends on the diskette you 
wish to copy. 

If the diskette is not copy-protected, use the FAST DISK BACKUP function 
by pressing 'F* from the main menu. 

If the diskette is copy-protected, use the TEXT EDITOR Backup function 
(*T* from the main menu, 'B* from the text editor menu) and determine if 
the name of the program is in the list of supplied parameters on the 
parameter diskette (inci uded with Locksmi th ) . If the* name 1 s found , 
select the name and the backup operation will begin automatically. 

If the name is not found on the parameter diskette, Try using the standard 
copy routines by selecting BACKUP/COPY (key *BM from the main menu. Most 
protected software can be copi ed using the standard back up /copy f unct 1 on . 

If you used parameters on the parameter diskette to backup your disk, but 
are still unable to successfully backup your disk, it is possible that a 
different protection technique is being used for that particular piece of 
software. Software companies frequently change protection techniques to 
make it as confusing as possible for those trying to copy the software. 
Call or wr i te our customer support group to f i nd out i f new parameters are 
available for your particular software. 

Finally, if you are techni cally ex per 1 enced and enjoy chal 1 enges , you 
mi ght con si der devel oping parameters to copy the software yoursel f . 
Locksmith has many useful tools to help you determine the type of 
copy-protection and help you either copy the software or disable the 
protect 1 on. 
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THE LOCKSI-1 r TH M^ I t\J METIMU 

Immediately after booting your Locksmith disk, the main menu appears. 

THE LOCKSMITH - VERSION 6.0 - REVISION A 

.00 

.25 

.50 

. 75 

HEX 00000000000000001 1 ! 1 ! 11 1 1 1 1 1 1 1 I 10000 

TRK 0123456789ABCDEF01234567B9ABCDEF0123 

B BACKUP/COPY F FAST BACKUP / CLR STATUS 

N DISK EDITOR L LOAD RAM CD * PARAMETERS 

T TEXT EDITOR R RAMCD UTILS Q SCAN DISK 

A BOOT TRACER C CERTIFY DSK U 16-S UTILS 

D D0S3.3 UTIL X DSK RECOVER S DISK SPEED 

E ERASE DISK 

I INSPECTOR 

CTRL-Z PRT SC RESET EXIT LS ESC RESTART 

The top 7 lines o-f the display are the track status display. 

The body of the main menu displays the keystrokes (in inverse) which you 
may enter at this time and a brief description of what function each key 
performs. The functions available in the main menu are each discussed 
separately in this manual. Briefly they arez 

CB] BACKUP/COPY - This function allows you to backup protected software 
using the Locksmith standard copy routines, which will backup most 
protected software without parameters. 

CF3 FAST BACKUP - The Fast Backup function allows you to quickly create 
backup copies of any unprotected software. Depending on the amount of 
memory in your system, this utility can backup a disk in as little as 8 
seconds ! 

C/1 CLR STATUS - Pressing the " / " key will clear the track status display 
at the top of the screen. 

CN] DISK EDITOR - The Disk Editor (formerly the Nibble Editor in earlier 
releases of Locksmith) can be used to manually read, search, change, and 
rewrite data, either in sector format or nibble format. In addition, the 
Disl Editor is used to edit DOS and PR0D0S files, and can be used to edit 
data on any RAM cards installed in the Apple. 

CL] LOAD RAM CD - This function will load a slot RAM card on an Apple II 
or Apple II Plus, or load the built-in 16K RAM on an Apple //e or Apple 
//c. This function loads 12K of data which is found on tracks 12, 13, and 
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14 (hex) of the Locksmith disk. If you own Inspector and Wat son , you can 
write them to these tracks, and they will be loaded whenever you select 
this function. Once loaded, Inspector and Watson Are available by 
press 1 ng the 'I' key from the mai n menu. 

C*3 PARAMETERS - This function allows you to display or change the current 
Locksmith operating parameters by name. For a complete list of all of the 
Locksmith parameter names, please refer to the Locksm: th Technical 
Reference Manual. 

CT] TEXT EDITOR - The Locksmith Text Editor is used to edit files 
containing Locksmith Programming Language (LPL), which can be loaded and 
saved to your Locksmith parameter disk. The BACKUP function of the text 
editor will allow you to automatically backup protected software after 
speci fying the name of the sof tware. 

CR3 RAMCD UTILS - The Locksmith RAM card utilities can be used to test RAM 
cards in the Apple. RAM cards of any size can be tested, and two tests 
are provi ded: a basi c test and an ex ten si ve test. The test can be 
performed once or continuously to help isolate intermittent errors. In 
addition, the contents of any 16K bank of the RAM card can be dumped into 
main memory, edited with the disk editor, and re-loaded to the RAM card. 

C03 SCAN DISK - Formerly known as "quick scan" in earlier versions of 
Locksmith, this utility allows you to examine on the hi-res graphics 
screen an overall "picture" of the diskette, track by track. This 
function is useful in determining how each track of an unknown disk is 
formatted. 

CA1 BOOT TRACER - The Automatic Boot Tracer is intended for use by the 
more experienced Apple programmer. It is actually a sophisticated 
debugger which can simulate the operation of the 6502 in the Apple. 
Because disk reading is simulated, it is possible to actually "boot" a 
dish (whether protected or not) under control of this debugger and trace 
the boot code of the program. 

EC] CERTIFY DSK ~ The Certify Disk function will write a special pattern 
to each track of the diskette and immediately read it back to make sure 
that no scratches or other imperfections on the diskette surface will 
affect the reading and writing of data to the diskette. 

CD] 16-S UTILS - This menu option will bring up a secondary menu 
containing useful 16-sector utilities. These utilities can be used to 
verify a diskette, compare two diskettes, format a diskette, or display 
the "sync signature" of a di skette. 

CD] DQS3. 3 UT IL - Thi s menu opt i on will bring up a secondary menu 
containing useful DOS 3.3 utilities. These utilities can be used to 
alphabetize a catalog, undelete a file, load a DOS file into memory for 
examination by the Disk Editor, show a disk free space map, fix incorrect 
sector counts in the catalog, identify and correct catalog/VTOC errors, 
and remove DOS from a disk to allow for the storage of more files. 

CXI DSK RECOVER - The Advanced Disk Recovery utility will read a difficult 
or impossible to read diskette and write a good copy to another diskette. 
This is especially useful for recovering data from diskettes which were 
wr l tten in drives which were al i gned improper 1 y. Advanced Di sk Recovery 
will actually recover data from a diskette which was written while 
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inserted in the disk drive off-center' 

CS3 DISK SPEED - This utility will allow you to check the speed of your 
disk drives so that you may adjust the speed to the standard 300 R. P. M. , a 
recommended speed which is slightly slower, or set the speed of the drive 
to the same speed that created a gi ven diskette. 

IE} ERASE DISK - This function is used to entirely or partially erase a 
di sket te. 

CI3 INSPECTOR - Invokes Inspector and Watson if the utility programs are 
available or have been previously loaded with the *L' menu item. 

IESC3 RESTART - At any time during the operation of Locksmith the "ESC* 
key may be pressed to abort the current f unct i on and return to the 
previ ous menu or mai n menu. 

CCTRL-Z 1 PRT SC - To print the contents of the ten t screen to the printer 
at any time during the operation of Locksmith you should hold down the 
' CTRL* key and press ' 1 ' . 

CRESET3 EXIT LS - To exit Locksmith hold down the 'CTRL' key and press the 
' RESET * key. This will cause an i mmedi ate reboot . 
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b^ckljf* / cof^y disk 

cb: backup/copy 

Pressi ng ' B' from the mai n Locksmi th menu will all dw you to make a backup 
copy of most protected software. If the disk you wish to backup is not 
protected, you will want to use the much faster FAST BACKUP utility (key 
*JF* from the main menu). 

The *B' (backup/copy) function uses the standard copy routines, which work 
well for most protected software. To use copy routines which are already 
tailored for a specific protected diskette, use the main menu *T* (text 
editor) function to select the name of the program you wish to back up. 
See the text-editor section of this manual for more information. 

After pressing *B* from the main menu, you Ate prompted for input and 
output dr i ves . I f you spec 1 f y the same dr 1 ve for both (if you have onl y 
one dr i ve) , you will need to swap disks for each track to be copi ed . You 
are then prompted for the range of tracks for the copy operation and the 
track increment. To use the default values displayed for track start, 
track end, and track increment, you may simply press the RETURN key. 
After specifying whether the tracks should be synchronized and whether the 
track 1 ength shoul d be preserved (a techni que known as "nibble count 1 ng " > , 
you will be prompted to 1 nsert the di skettes for the copy operat 1 on, and 
the backup will begin. 

The track status display at the top of the screen will contain the status 
codes for each track copi ed . A zero i ndi cates that the track cop i ed with 
no errors. Other codes indicate errors whi ch have occurred whi 1 e copy l ng 
the track. Since the status codes are dependent on the LPL (Locksmith 
Programming Language) being executed, refer to the individual LPL file for 
a descripti on of status codes and error messages. 
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f^^ST O I SK BACKUP 

[F] FAST DISK BACKUP 

Pressing * F ' from the Locksmith main menu will enter the Fast Disk Backup 
utility. Fast Disk Backup (FDB) is intended to be used to backup 
unprotected diskettes. 

FDB is very fast. It reads a disk in as little as 8 seconds, and writes a 
di si in about the same amount of t i me. Opt l onal ly verifying the wr 1 tten 
data by reading it back and comparing it requires another 8 seconds, if 
it's desi red. 

Laclsmith FAST DISK BACKUP is the FASTEST Apple copy program with or 
without the use of RAM boards. 

Locksmi th 6.0 FDB can automat i cal 1 y swi ten between two dr l ves and wri te 
disks from memory, producing a new disk every B seconds. This is very 
useful for mass-product l on of software for cl ubs or software 

manuf act urer s. 

FDB will automatically recognize any RAM cards in your Apple, whether they 
are in slots 0-7 or in the aux iliary slot of the Appl e //e. The auxi 1 lary 
64K present on the Appl e //c is also used. Both the Appl e //e and Appl e 
//c have a built-in 16K RAM which appears as slot 0. RAM boards from 
several manufacturers, including Checkmate Technology, Applied 
Eng i neer ing, and Ti t an Techno 1 ogy have been tested with Loci smith 6.0 and 
work well. Locksmith FDB will recognize 16K, 32K, 64K, 12SK, and 256K RAM 
cards. To copy an ent ire disk into memory requi res 1 401 ' ( 4K per track) . 
FDB uses 40K of main memory for track storage, and therefore needs 100K in 
RAM cards to make one- pass cop i es or copi es ent i rely from memory. All 
slots, including slot 3, are searched f or RAM cards. 

F^ass-t Di sik B a*= k u p» Commands 

Simple commands are entered from the keyboard . After pressing the return 
key, the current command can be seen in the current command display are a 
in the 1 ower left of the screen. The default command is "12", which means 
to copy drive 1 to drive 2. 

A complete list of commands: 

1 2 copy drive 1 to drive 2 

21 copy drive 2 to dri ve 1 
11 copy drive 1 to drive 1 

22 copy drive 2 to drive 2 

1 read verify drive 1 

2 read ver ify drive 2 

1 copy drive 1 into memory 

20 copy drive 2 into memory 

01 copy memory to drive 1 

02 copy memory to dr i ve 2 

V turn ver l f y-af ter-wr i te flag on or off 

[space] or. [return] begins the copy or verify operation 

[reset ] ex i ts Fast Disk Backup 

[control-?] prints the screen to a printer 

[control -X] can eels the key entry 
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In addition to the commands listed above, there are several parameters 
which can be modified from within FD6. These parameters can be used to 
allow FDB to read and write sector oriented protected disls, and set 
internal FDB operating parameters. Here is a list of some of the more 
useful parameters, along with their initial default values, and a 
description. 

0007=00 Requested output volume number or zero, if same as input 
volume. 

0008=00 Begin track to process. 

0009=22 End track to process. 

0010=08 Maximum read retry count. The retry number is displayed as 
1-9 for the first nine revolutions of the disl and A-Z for 
the next twenty-si:<. After that the display will not 
change. 

0011=03 Maximum verify after write retry count. 

0012=10 Motor On delay for read. Mai. i mum value is 7F. 

0013=10 Motor On delay for write. Maximum value is 7F. 

0014=80 Seel Off delay for read. DOS uses FF, the longest value. 
A value of 00 is satisfactory and will reduce the overall 
copy time by about a second. 

0015=80 Seek Off delay for write. It is not recommended to change 
this value below 80 because the drive may begin writing 
before the seek mechanism has settled. 

0016=06 Number of self-sync before address field. This number is 
expressed in excess-5 notation. For example, the default 
of 0B will write sixteen self-sync nibbles and the value of 
01 will write 6 self-sync nibbles. Setting this value very 
low will create a disk which cannot be written to because 
writing a data field would over-write the subsequent 
address field. Setting this value too high will cause a 
problem fitting all of the sectors on the track. 

0017=08 Number of self-sync before data field. If this value is 

too low, neither DOS nor FDB will be able to read the data. 
Setting this value too high will cause a problem fitting 
all of the sectors on the track. 

0018=00 Alternate writing to drive 1 and 2. Setting this flag to 
FF will cause FDB to alternate writing between two drives, 
allowing for very fast and efficient disk copying from 
memory. 

To change parameter* within FDB, enter the 4-digit address and press 
return. The current value will be displayed and you can key over the 
value to change it. 

While the copy operation is in progress, the ESC key can be used to 
cancel /abort the copy operation. The 'V* key can be used to turn on or 
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turn off the ver i f y--af ter-wr 1 te f 1 ag . 

Locksmith will read and wr 1 te a disk wi thout RAM boards in 19 seconds, 
copying 10 tracks per pass. 14 verifying after each write, the disk is 
copi ed in 26 seconds . 

The following table summarizes timing tests done with some popular copy 
programs wi thout the use of RAM boards: 

t i me t i me to 
trks/ to copy & 
Program pass copy ver i f y 



Locksmith 6.0 10 19 26 

Penulta Copy 5 3B 

Di sk Muncher 7 26 

Pack Rat 4 35 

Apple COPYA 8 88 



Also note that Disk Muncher and Pack Rat do NOT validate checksums during 
read, and Are thus ex tremel y unreliable. 

If RAM boards Are found to total at least 100K (128K RAM boards work 
fine), the disk can be read in 8 seconds, and a copy disk written in 8 
seconds. If ver l f y-af ter -wr l te is desired, the disk is written in 15 
seconds . 

The foil owi ng t abl e summar izes timing tests done with some one-pass copy 
programs with the use of 1 28K RAM boards: 

1 1 me 1 1 me t i me to 
to to wr i te & 
Program read wr l te ver i f y 



Locksmith 6.0 8 8 15 
Copywr l ter 24 16 23 

Copy Cruiser 9 16 23 

Note that CopyWr i ter also has a 'read-twice' mode whi ch takes 45 seconds 
to perform instead of 24 seconds, but can be more rel i abl e on or i g i nal 
disks r ecorded on quest i onab 1 e media. 
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CLEAR TRACK STATUS D I SRL_ A Y 

1/1 CLR STATUS 

The track status display at the top of the screen is not cleared after 
each Locksmith function, so that the user can use the status display with 
other functions. To clear the status display, press the '/' key from the 
main menu. 

disk, nibble:, and memorn editor: 

cn3 disk edit 

Press i ng * N* from the main menu ^i 1 j select the Dl sk Editor. This 
function was referred to as the Nibble Editor in previous versions of 
Locksmith, but it has been expanded to be able to ed 1 1 sec tors, ent ire 
tracks of sectors, DOS f i 1 es, and RAM card data in additi on to disk 
nibbles. The keystroke 'N" to invoke it has been kept for compatibility 
with earlier versions of Locksmi th. Some text in this manual may still 
refer to it as the Nibble Editor. 

The following single keystroke commands are supported by the disk editor: 

cEsca 

Pressing the * ESC* key will always abort the current operat 1 on and 
return you to a menu. 

CCTRL-Z3 

Thi s opt l on i s act i vated by pressing and holding the key mark ed 
'CTRL' and pressing the * Z * key. This opt l on i s a screen print. It will 
pr l n t whatever l s showi ng on the text screen at the 1 1 me it is pressed. 
This is assuming that you have a printer turned on and that Loc ksmi th has 
been told the correct slot for the printer interface card. 

Now we will cover how to move around within the buffer. 

CURSOR MOVEMENT: 

The disk editor cursor consists of a flashing box on both sides of the 
nibble or byte of data. 

Locksmi th supports the normal Appl e II cursor movement k eys. 

UP 
CI3 
LEFT CJ3 CK3 RIGHT 
CM1 

DOWN 

You may also move left or right with the left and right arrow keys. 

I f you have an Appl e //e the up and down arrow keys are also oper at l onal . 

I f you move left past the beginning of the line, you will be pi aced on the 
last character of the previous line. Similarly, if you move past the end 
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of the current line, you will be pi aced at the begi nning of the next line, 

CO 

Pressing the ' <' key will move backwards through the buf-fer one 
screen page, unl ess you are already at the beginni ng of the buf f er . 

CM 

Press 1 ng the ' >* key will move forward through the buf-fer one 
screen page, unless you are already at the end of the buffer. 

Press ing the * , * key will all ow you to scrol 1 cont i nousl y back 
through the buff er unt i 1 ei ther a key i s pressed or you reach the 
beginning of the buffer. 

C. 1 

Press l ng the ' - ' key will all ow you to scrol 1 cont l nousl y forward 
through the buf f er unt i 1 ei ther a key is pressed or you reach the end of 
the buffer. 

DISPLAY CONTROL COMMANDS: 

CAJ 

This key toggles the display of ASCII data to the right of the hex 
display. The ASCII display is normally meaningless for nibble data, so it 
is normally turned off. 

TBI 

Thi s l< ey toggles the display between nibble mode and byte mode. 
In nibble mode, self-sync nibbles are displayed in inverse text, while 
normal nibbles (not self-sync) are displayed in normal text. In self-sync 
mode, all data is displayed with the high order bit turned on, because all 
nibble data by definiti on has the high order bit on . In byte mode , all 
data is displayed in normal text with the high order bit of each byte left 
l nt ac t . 



CONTROL KEY COMMANDS: 

CCTRL-R3 

Pressing 'CTRL-R' will allow you to read a track into the buffer. 
You will be prompted with TRACK: . I f you have previ ousl y read a track 
into the buffer, that track number will also be displayed. The Current 
default drive for the track read will al so be di sp 1 ayed - If you wi sh to 
reread the same track just press the RETURN key. If not then enter the 
number of the track you wi sh to examine. You may enter a dec i mal poi nt in 
the track number. The track number you enter will be multiplied by four 
before it is stored internally. This is necessary due to the way 
Loci-smith finds the tracks specified. After you have entered the track 
number you wish, press the RETURN key to tell Locksmith you are finished 
with the entry. The cursor will move to the dri ve entry to all ow you to 
change the default if you wish. If you want the default drive, press 
RETURN. The first time you read a track into the nibble buffer Locksmith 
will recalibrate. If you wi sh to recalibrate at any other t i me enter 
CTRL-R and when the prompt TRACK: appears enter the track number, followed 
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by 'R* and press the return key. This will farce Locksmith to 
recal ibrate. 

ECTRL-W3 

Entering a 'CTRL-W tells Locksmith to write the current track 
back to disk. You will be prompted with TRACK:. inter the number of the 
track you wi sh to be wr i tten to the disk foil owed by return . Press 1 ng 
return will write the data to the current track that was read. Next the 
cursor will be placed on the default drive number for the write. If you 
wish to use the default drive just press RETURN. If you wish to change 
the def aul t , enter the number of the drive you wi sh to wr 1 1 e to. 
WARNING' IF NO ANALYSIS HAS BEEN DONE ON THE TRACK TO SET THE TRACK START 
AND TRACK END LOCKSMITH WILL ATTEMPT TO WRITE THE ENTIRE BUFFER. 

CCTRL-V3 

This command is used to tell Locksmith where to start verifying 
the track start after it writes the track to the disk. The series of 
bytes that follow the verify start are the ones that are checked when the 
track is wri tten to disk. This is done to male sure that the beginning of 
the track was not overwr 1 tten and destroyed by the end of the track. 
Normally, if the ver lfy bytes ^r e overwr 1 t ten the track will be shortened 
and rewritten until they arts not overwri tten or until the track can no 
1 onger be shortened . If the track can no 1 anger be shortened you will get 
a ver lfy error. Thi s error may possibly be corrected hy adjusting the 
copy drive to a si ower speed pr 1 or to writing the track. 
To set verify start, place the cursor on the nibble you wish to start 
verifying, and press CTRL-V. This will set the verify start to this 
location. There will be a ' V* displayed in front of the nibble you 
sel ec t ed for verify start. 

CCTRL-I ] 

This command is used to add nibbles to the current buffer. When 
you enter * CTRL- 1' the nibble that is at the current cursor 1 ocat i on i s 
dupl l cat ed and all the nibbles to the right are moved one posi t l on to the 
r i ght . 

CCTRL-D1 

Thi s command i 5 used to delete nibbles from the current buffer. 
When you enter 'CTRL-D' the nibble that is at the current cursor location 
is deleted from the buffer and all the nibbles to the right of the cur^ar 
are moved one position to the left. 

rCTRL-FI 

Thi s command is used to find different patterns of nibbles within 
the buffer. Enter CTRL-F, and you will see the prompt FIND:. The Find 
Command has two opt i ons: 

CRETURN] 

Pressing the return key will cause find to use the pattern in 
the string variable PATO. You can set this variable with the LPL 
command processor described elsewhere in this section of the manual. 

[LD 

Entering * L ' will give you the prompt LENGTH:. You may now 
enter in a length from <1-F). This instruction tells Locksmith to 
start looking forward through the buffer for a pattern that matches 
the one that starts at the current cursor position and is LENGTH 
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nibbles 1 ong . When the pattern is f ound , the cursor will be moved 
forward in the buffer to the first nibble of the matching pattern. 
If you wi sh to repeat the search f ram your present cursor posi t i on , 
type 'CTRL-F' and press the RETURN key. This repeats the last search 
again. If Loci smith is unsuccessful in its search for the pattern, 
the cur sor will not move and Locksmi th will print in i n verse at the 
top right of the buffer 'NOT FOUND' and beep. 

Earlier versions of the Nibble Editor had three other options to the Find 
command. The (find other), P (find pattern name), and D (find data). 
Because of the capability of using LPL directly from within the Disk 
Editor of versi on 6.0, these opt 1 ens Are no 1 onger needed within the Disk 
Ed i t or . The equival ent LPL commands arei 

NEXT. DIFF finds the next nibble in the buffer different than the one 
at the cursor. This is equivalent to the find "0" (other) option. 

FIND PAT4 finds the next occurrence of the data contained in the 
variable PAT4. This is equivalent to the find "P" (pattern name) 
opt l on . 

F IND D5 A A 96 finds the next occurrence of the data suppli ed by the 
user. This is equival ent to the find "D" (data) opt l on . 

MISCELLANEOUS COMMANDS = 



CCTRL-B3 Moves the cursor to track start. If the cursor is at track 
start, the cursor is moved to begi nning of buffer at 2000. 

CCTRL-E 3 Moves the cursor to track end. If the cursor is at track end , 
the cursor is moved to the end of buffer at 7FFF. 

C<] Sets track start to current cursor position. 

C) 1 

Sets track end to current cursor position. 

CSJ 

Sets the nibble under the cursor to self sync. 



Sets the nibble under the cursor to normal 

cci 

Change mode. Enter hex data and press RETURN to exit change mode. 
You may al so use the left and right arrow keys and the space bar in change 
mode. This changes the data under the cursor to the hex values entered. 
Pressing the space bar moves the cursor to the next positi on. The 
commands 'S' and 'N' also work in change mode. 

CHI 

Entering 'H* will display the current buffer on the hi-res screen. 

CHG1 

Entering a *G' while in hi-res mode will print the hi-res screen 
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i f you have a printer capable of hi-res graphics and a graphics pri nter 
interface card. The print er string requi red by your pr 1 nter may be 
defined by the parin 'GRCHARS'. The default is set to CTRL-I G <CR> CTRL-Q 
<CR>. This string works for both Si 1 en type and Epson printers with 
interfaces that support graphic screen dumps. 

C63 

Entering a *G* from the text mode of the Nibble Editor will 
display a picture of the buffer using text characters. Each locaton on 
the screen represents a string of nibbl es in the buffer. The 1 eny th of 
the string (samp le interval) is defi ned by the parm ' IS AMP' , and defaul ts 
to *0A. (Note: for 1 3 sector disks, a value of #0C wor ks wel 1 ) . On the 
graphic display the foil owi ng symbol s are used . A per l od ' . * means that 
all the nibbles in the string are normn 1 (non-sel f sync > . An inverse '**' 
means the nibbles are all self sync. The '+* means the nibbles are a 
combination self sync and normal. 

The cursor may be moved within the screen area using the I,J,K,M keys or 
the arrow keys. The cursor may be moved to the locati on on the screen 
correspond l ng to the Are a in the nibble buffer that you wish to examine. 
Pressing any other key at this point will return to the nibble display 
with the cursor set to the Are a you selected. 

HINT: The display starts at either buffer start or track: start and the 
display may not be centered. Move the cursor to the center of the screen 
and press the RETURN key. It will take you back into the Nibble Editor. 
Set tract, start '(* and press '6* again. The display will now be 
centered . If the disk you are examining is a 16 sector disk, you will see 
one pattern of ' K* s that is larger than the others. This is the field of 
sel f sync in f r ont of sector zero. Move the cursor to the first peri od 
' . * foil owi ng the large number of * #' s and press RETURN. You will now be 
back in the Nibble Edi tor and the cursor should be near the first nibble 
in the address header for sector zero. 

cd: 

Th is is a 16 sector address decode command . You will see two 
col umns di spl ayed on the screen . They are decoded in the foil owi ng 
manner . 

The first f our numbers in l n verse are the buffer address. Nex t is the 
letter 'V followed by a hex number . Thi s is the vol ume number of the 
disk. Ne;< t i s a two digit hex number foil owed by a '/* foil owed by 
another two digit hex number. This is the track number /sec tor number. 
This field may be fol lowed by any of these three symbol s "V,*CS *,'**' or 
l f not hi ng is wrong it will be foil owed by a bl ank space. They have the 
following meanings. The '?* means that either the check sum or the 
trailer was incorrect in the address field. The 'CS* means the data field 
check sum is bad . The * » * ' means there is someth ing wrong with the data 
field information. It is either a bad data field header or trailer. If 
the disk is a 13 sector format, '**' will appear for all sectors. 

As mentioned above, **»* indicates that either the data field header (DS 
AA AD) or data field trailer <DE AA) is incorrect. If they both appear 
correct, but are st l 1 1 marked with '**', the trail er is probably in the 
wr ong 1 ocat ion. Exactly 343 nibbles should occur between the header and 
the trailer. (342 data nibbles and one checksum nibble) A simple way to 
test this is to perform the following. Place the cursor on the DZ of the 
header field <D5 AA AD). Now, press *>■ (shifted) 3 times, 'I* 5 times, 
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header field (D5 AA AD). Nuw, press * >' (shifted) Z times, 'I* 5 times, 
and *k' twice. The cursor is now where the trailer should start. If the 
cursor is not on the DE of the trailer <DE AA) , the trailer is nut in the 

correct locati on . 

The addr ess field nibbles occur in doubl e-nibble for mat after the address 
field header (D5 AA 96) and r ©present the vol ume number , track number , 
set tur number , and checksum. A char t to decode the address field 
doub le- nibbles is locat ed in the append i x . 

The data field nibbles consist of 342 data nibbles after the data field 
header ( D5 A A AD ) plus an additi onal 343rd nibble, whi ch is used for the 
data field checksum. This checksum is calculated by taking each of the 
342 data nibbles, tr an si ating them according to a chart < whi ch is supplied 
in the appendix), and exc 1 usi ve-or ' i nq them together to form a checksum. 
The r esul tiny check sum is then r ever se t ran si at ed using t he same table and 
bet times the 343rd rubble. Not e that onl y 64 d l f f er ent ni bbl es dr e pr esertt 
in this table. Data fields are validated onl y by this 6-bit checksum, and 
data rubbles each cunt din only 6-bits of informati on each . 

If the disk is using a nan standard address or data header you will not 
receive this information unless you set PARM:S£CAF to the correct address 
field pattern and FARM: SECDF to the correct data field pattern. 

C»] 

Pressing the '#* key from within the Nibble Editor prints the 
current track in the buffer from *(' track start to ')' track end to your 
printer. The self sync nibbles will have **' on either side of them in 
the pr i nt out . The track verify start will have the letter 'V in front of 
the verify start nibble sequence. 

r RETURN 1 

Pressing t tie RETURN ley places the prompt "LPL: " above the data 
eft 1 . play. You may enter ai> LF'L statement at this time. The I PL statement 
may tie a SHOW command to display the value of a named variable, a v^tr table 
name assignment statement , or a processing routine to invoke. See the 
chapter on LF'L for mure information. 

[ CTRL 5] 

Pressing c ontr ol - S will process the analysis porti on of the 
current tract pr oc edur e. This is used after reading to analyze the nibble 
data and set pointers for later writing. 
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f^Fi^MIIMCS OIX ANALYZER 

The framing bit analyzer is intended as. a tuul for the more advanced 
Lqc ksmi th user . 

Fr ami ng bit* (somet 1 mes call ed "aync bits" or "timi ng bits") Are the z ero 
bits that occur between some ni bbl es of data an the di sk ■ These nibbles 
mi t h f r ami ng bits Are call ed sel f -sync nibb les. Each bit of ni bbl e data 
r equi r es 4 mi croseconds to read or wr 1 te. An B-bi t nibble of raw di sk 
data with no framing bits theref ore requi res 32 mi cr usee onds. For each 
f r ami ng bit occur r 1 ng af ter the 8-bi t nibble, 4 m cr usee onds Ar** added to 
this t i me. A 10-bit (2 f rami ng bit) sel f -sync nibble therefore r equir es 
40 mi croseconds to read or wr i te. 

13-sector DOS (DOS 3.2 and earlier) used 9-bit self sync (1 framing bit) 
while 16-sector DOS (DOS 3.3 aikS PR0D0S) use 10-bit self-sync (2 framing 
bits). It is also possible to write 3 or more f rami ng bits after a nibble 
of data al though if 3 or more f r ami ng bits occur , it is mor e likely that 
sync may be lost by the disk controller while reading. 

Some copy pro tec 1 1 on techniques rely on self-sync data with a specific 
number of framing bits on a specific nibble of data un trie track. This 
can be detected in a number of ways. One way to determine framing bit 
i n f or mat 1 on is to cause the disk control 1 er shi ft register to deliberately 
1 use sync. This c auses the normal ly invisible framing bits to be sh i f ted 
into the disk control 1 er shi f t r egi st er . This method doesn ' t wor k with 
some models of disk drives. Another method to determine the number of 
framing bits is to perform a statistical analysis of the timing of the? 
di si data using sever al reads of the same data. 

The framing bit anal yz er performs a statistical anal ysis using precise 
timing loops and reports the timing relationship of the nibble data. The 
framing bit analyzer reads the track data repeatedly, each time updating 
cummulative timing statistics for each nibble of data. After several read 
passes, this timing information c^n precisely determine the number of 
timing bits used to write any nibble of data on the disk. 

The framing bit analyzer is entered by pressing '** from the dist editor 
after reading in a track from disk and manual ly setting certain poi rit ers 
i n the tr act buffer. 

Let's use an ex ampl e to describe the use of the framing bit analyzer, In 
the disk editor, use the control -R command to read a tract of nibbles. 
Place the "(" start pointer on the start of an address field ( D5 AA 96). 
Move the cursor down about 10 lines and set the ")" end pointer. Now move 
the cursor back up to the "DE AA" after the start of the address field <D5 
AA 96) . 

The framing bit anal yzer uses the data from the start pointer " (" to the 
rubble immediately before the cursor as a "key". If you placed "(" before 
the D5 nibble and the cursor on the DE nibble, the key length would be *0B 
(decimal 11) nibbl es. 

Enter the f r aming bit anal yzer by pressing the "♦" he/. The displ ay shows 
the data being analyzed on the left side of the screen with statistical 
l nf or mat l on on the right. 
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The following command l-eys control the framing bit analyzer: 

The space bar temporarily stops the analyzer so you may examine the 
statistics. Pressing the space bar again will cause a single read to 

oc c ur . 

The RETURN key starts the analysis agat n . 

ESC e::its the framing bit anal yzer and returns to the disk editor. 

" < " and " >" al 1 ow you to scrol 1 through the buffer if it is mor e than 
one screen in 1 ength. 

"T" switches the display from nibble data to the timing statistics 
information associated with each nibble. 

The timing statistics information associated with each nibble would be 10 
for an ideal normal 8-bit (no framing bit) nibble, 20 for an ideal 9-bit 
(1 framing bit) nibble, 30 for an ideal lObit (2 framing bit) nibble, and 
so on. Timing statistics between these "ideal" values indicate 
differences between the writing and reading drive speeds and statistical 
error due to the number of samples read. This errur is reduced when mure 
samples are taken. 

the right side of the screen is a statistical summary 
d mi ght 1 ook like the foil owi ng : 
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The "R-" va 1 ue is the number of reads wh l ch occurred. The "F-" va 1 ue is 
the number of reads l n which the "key" of the data was found on the trad. 
Because of limited buffer space, if a large data length is specified, it 
is possible that the buffer may not fully contain the data specified. 

The table of numbers represents the count of the differences of the data 
read with the "ideal" values of 10, 20, 30, etc. These error difference* 
range frum -7 to +7, with 00 being the ideal . For example, in the t abl e 
shown above, the count for +1 1 s 25 (hex > . Thi s means that ther e am 25 
occurrences of nibbles with timing values uf one greater than the ideal 
val ue <11, 21 , 31 , etc; . ) . The "8" count of 03 indicates 3 occur r ences uf 
timing values exactly halfway between ideal values. This indicates that 
more samples are needed. The ■''?'" , " is displayed when the values for the 
+/- 6,7, and 8 counts are non-zero, and indicates that mure samples are 
needed. 

When nibble data is displayed on the left side, the inverse/normal mode of 
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each nibble indicates the number of framing bits dUer the nibble. Nor mal 
text 1 ndi cat es no * r ami ng bits. Both digits art* inverse if 2 framing bits 
whi 1 e onl y one digit is inverse if 1 f r ami ng bit. A tl ashi ng val ue 
i ndi cat eh 3 or more f r ami ng bits. 

If the ni bbl e data has the high order bit turned off, this indicates that 
at 1 east one read occurred where the data af ter the Le/ did not match. 
This coul d have been caused by a 1 oss of sync whi le r eading or by the key 
being spec l * l ed as too short whi ch caused a non-uni que par t uf the track 
to be anal y z ed instead of the desi red par t . 
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l_ O £\ O R: A M CARD 

CLl LOAD RAM CD 

Pressing the * L* hey <rom the main menu will cause tracks * 12, *1 3, and *1 4 
to be read into memory addresses *DOOO through *FFFF of a RAM card in SLOT 
0. 1+ you have an Apple //e or //c, there is a "built-in" slot 16K RAM 
card already in your system. 

If you own Inspector / Watson, you can place them on your Locksmith disk 
by using the -following procedure and then quickly load the RAM card when 
Locksmith is booted by pressing 'L' -from the main menu. 

Your Locksmith diskette already contains a RAM image of INTEGER BASIC and 
the mon 1 tor on tracks * 13 and *14. To install Inspector / Watson on tr aak 
* 1 2, foil ow these instructi ons : 

Boot a copy of a disk that contains your copy of Inspector and 
Wat son - Then enter Inspector or Watson , i nsert a copy of your 
Locksmith diskette and press the foil owi ng keys; 

B D <return> 
T 1 2 'return > 
control -W 

Then press the control -I key 15 t 1 mes. Inspector and Watson are now 
placed on your Locksmith diskette. 
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F>« Fi ^ M EI T EI Ft s 

C*3 PARAMETERS 

Pressing the *•' key from the main menu will all ow y ou to di spl ay and set 
Locksmith parameters. Parameters are displayed and modified using their 
parameter name (LPL variable name). 

To ex i t from the parameter funct i on press the ESC key . 

To display the value of a parameter, enter the l-eyword "SHOW" followed by 
the name of the parameter . For ex ampl e, to di sp 1 ay the current val ue of 
the parameter SLOT, enter: 

SHOW SLOT 

To change the val ue of a parameter , si mpl y enter its name i ol 1 owed by the 
val ue you wi ah to assign to it. For ex ampl e, to change the val ue of the 
parameter SLOT to 4, enter : 

SLOT 4 

If an error was made in enter i ng the command , the speak er will beep , and 
the command will be l gnored . Si mpl y type it agai n correct 1 y . 

To display the addresses of the parameter names as they atre being 
displayed, set the parameter SHOW.ADDR to the value YES, as follows: 

SHOW.ADDR YES 
Now i f you enter the command : 

SHOW SLOT 

the address of the parameter SLOT is displayed in addition to its value. 

Any named Locksmith parameters can be displayed and changed in this 
manner . 

Here ^re a few useful parameters and a brief descripti on of what they ^re 
used for: 

SLOT is the slot number of the disk drive Locksmith is to use for 
disk functions. For example: 

SLOT 4 

PRT. SLOT is the slot number which contains the interface for the 
printer to be used for print, print screen and graphics print 
commands . For example: 

PRT. SLOT 1 

6R. CHARS is a string variable (maximum length of 15) which contains 
the printer setup string which will cause the interface to print the 
graphics screen. Lock smith sends this string to the printer when the 
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*G' V ey is pressed while a graphics screen is displayed in the Disl 
Bean or Disl Speed utilities. The following statement sets the setup 
string to rontrol-I 'GRD', which will cause Grappler and GrafStar 
print er interfaces to print the graphics screen rotated and 

daub 1 e~s i:e: 

GR. CHARS 89 'GRD' 8D 

L5. SLOT is the name of the parameter to change the drive slot from 
whi ch Loci smith will load over 1 ays from. For e;: amp 1 e: 

LS.SLOT 5 

The following statement, whi le not really a parameter , can he useful 
to assist in reading sectors from a disk that reads unreliably. This 
patch to RWTS inhibits the recalibrate of the disk head after an 1/0 
error occurs and instead will retry the read operation until it 
succeeds. The second statement listed below removes the patch and 
all ows normal reading of sectors. Note that with this patch 
i nst a 1 1 ed that sector reads for a sector that is permanently bad will 
never terminate. If this occurs, si mpl y remove the bad diskette arid 
replace it with a good one until the read terminates normally. 

BDCC 4C CI PD 
BDCC 10 F3 AD 
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TEXT" EDITOF? / l_F=-L_ 

CT1 TEXT EDITOR 

The Locksmith te:;t editor is entered from the main menu by pressing the 
*T' Key. The text editor is a special purpose -file editor which is used 
to edit Locksmith Programming Language (LPL) files. These files can be 
loaded from and saved to a Locksmith Parameter Dl'-l ette, which is included 
with the distribution of Locksmith 6.0. The parameter diskette (sometimes 
referred to as the "parmdisk") is not copy protected, yet is formatted in 
a special way to maximize use for saving many parameter files. The free 
space and alphabetical directory on the parmdisk is automatically managed 
by the text editor. 

After entering the text editor menu, the display screen will show the 
following choices: 

cl: load file 

cs3 save file 

cd: delete file 

[xi syntax check 

cc1 change slot and drive 

[)] initialize parmdisk 

cz1 parmdisk statistics 

ie1 enter editor 

[n] new file 

:p: PRINT FILE 

[A] PRINT ALL FILES 

IB] BACMJP / COPY DISK 

By pressing a single key from the text editor menu, any text editor 
function can be selected. 

BACKUP USING CUSTOM PARAMETERS 

CB3 BACKUP / COPY DISK 

This text editor function is used to automatically select a parameter file 
to be used to backup a disk with a minimum of keystrokes from the user. 
To enter this function from the text editor menu, press the 'hi' ley <"NFW" 
clears the work buffer if any file is currently loaded) followed by the 
'B' ley (backup / copy). 

If the parmdisk is not in the selected drive you will be prompted to 
insert it. After the parmdisk directory is read into memory, a list of 

Locksmith 6.0 Page 30 User's Manual 



parameter files contained on the parmdisk 1b displayed. The "light bar" 
will be positioned on one of the names, probably the -first one if no 
parmdisk operations have been previously performed. To move the light bar 
to select a different -file, you can press one of the following keysi 

[up-arrow] and [down-arrow] will move the light bar up and down. If you 
have an Apple II or II PLUS you can use [control -K] to move up and 
[control -J 3 to move down. 

[control-N] (next page) and [control-P] (previous page) can be used to 
scroll ahead or backward one complete page of names. 

If you know the name of what you are looking for, you may enter the first 
character of the name. The light bar will be immediately positioned on 
the first name beginning with the character you entered. You may furthur 
qualify your suggestion by entering more characters of the name or may use 
the up and down arrow keys to move the light bar. The left and right 
arrow keys move the cursor in the name key-in field. The name key-in 
field always shows the current name selected. 

If while entering a name to select, you enter a character that causes the 
name key-in field to contain a file name that is not in the directory, the 
speaker will "beep" and the light bar will be positioned on the name 
closest to the one you have entered so far. 

To select a file name for backup, press the RETURN key. The file will be 
loaded from the parmdisk, automatically syntax checked, and control will 
be transferred to the Locksmith backup/copy routines after suitable 
prompts for you to insert the Locksmith diskette and finally, the 
diskette(s) to copy. The backup/copy routines will automatically copy the 
proper tracks with the proper LPL parameters. 

LOAD A PARAMETER FILE 

[L3 LOAD FILE 

Press 'L* from the text editor menu. If the parmdisk is not in the 
selected drive you will be prompted to insert it. After the parmdisk 
directory is read into memory, a list of parameter files contained on the 
parmdisk is displayed. The "light bar" will be positioned on one of the 
names, probably the first one if no parmdisk operations have been 
previously performed. To move the light bar to select a different file, 
you can press one of the following keys: 

[up-arrow] and [down-arrow] will move the light bar up and down. If you 
have an Apple II or II PLUS you can use Ccontrol-K] to move up and 
[control -J] to move down. 

[control-N] (next page) and Ccontrol-P] (previous page) can be used to 
scroll ahead or backward one complete page of names. 

If you know the name of what you are looking for, you may enter the first 
character of the name. The light bar will be immediately positioned on 
the first name beginning with the character you entered. You may furthur 
qualify your suggestion by entering more characters of the name or may use 
the up and down arrow keys to move the light bar. The left and right 
arrow keys move the cursor in the name key-in field. The name key-in 
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field always shows the current name sel ec ted . 

I f whi 1 e enter 1 ny a name to select, yon enter a character that causes the 
name key-in field to contain a -file name that is not in the directory, the 
speaker will "beep" and the light bar will be positioned on the name 
closest to the one you have entered so far. 

When the light bar is on the name you wish to select, press the RETURN 
key. The file will be 1 oaded into the work area. 

SAVE A F^^RT^METEFt F=" I L_E 

CSD SAVE FILE 

Press the ' S* Key. If the parmd 1 -si i ^ nut in the selected drive you will 
be prompted to insert it. Af ter the parmd 1 6k di rec t or y is read into 
memor y , a list of par ameter f i 1 es cont a ined on the parmd is I is displayed. 
The "light bar" will be pasiti oned on one of the names, probab ly the last 
name you prev i ousl y used . To use the same name (replace file), si mp 1 y 
press the RETURN ley. To move the light bar to select a different file, 
you can press one of the foil owi ng keys: 

Cup- arrow] and r down -arrow 1 will move the light bar up and down . I f you 
have an Appl e II or II PLUS you can use C control -K 1 to move up and 
£ Lantrol -J 1 to move down . 

C control -Nl (next page) and [control -PI (previ ous page) can be used to 
scrol 1 ahead or bad ward one compl ete page of names. 

If you Know the name of an existing file you wish to replace, or want to 
name your file with a si mi 1 ar name to an existing file, you may ent er the 
first character of the name. The light bar will be immediately positioned 
on the first name beg inning with the character you entered . You may 
furthur qualify your suggest i on by enter i ng more characters of the name or 
ma/ use the Lip and down arrow keys to move the light bar. The left and 
right arrow keys move the cursor in the name key-in field. The name 
ley-in field always shows the current name selected. 

If while entering a name to select for saving, you enter a character that 
causes the name ley-in field to contain a file name that is not in the 
directory, a new name will be displayed in the key-in ar&a with the words 
"ADD FILE:" displayed. Key over using *the space bar, any unwanted 
characters and press the RETURN key when you are f ini shed specifying the 
name you wish to save. The name will either be added or replaced, 
depending on whether the name already ex i sts. 

NEW — CI_E*^FC EDIT WORK **F:E^ 

CN3 NEW FILE 

Pressing the T N' Key from the text editor menu causes the text editor work 
area to be cleared. Any file contained in the work area not already saved 
on the parmdisK is lost. If you have made changes that you wish to Save, 
be sure to save the file before you clear the work area. 
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OH#->tNir3E SL.OT «|x|D DRIVE 

CC] CHANGE SLOT AND DRIVE 



Pressing th» 'C* key will prompt you for a new slot number and drive 
number of the disk to use for the parameter disk. Either enter a new slot 
and drive number or press the RETURN key to use the default values 
di spl ayed. 



F^AR^r-IETEF* DISK STATISTICS 

CZ: PARMDISK STATISTICS 

Press the 'I' key to display statistics about the parameter disk. The 
information displayed is in two parts. Information about the "CATALOG" 
directory is displayed first, followed by information about the "DATA" 
portion of the parameter diskette. Shown below is an example parameter 
disk statistics display. 

VOLNAMElLS 6.0 PI 

DISKETTE STATISTICS 

»•*«• CATALOG ***** 

364 FILES 
6071 BYTES FREE 
5705 BYTES USED 

13 AVERAGE FILENAME LENGTH 

ENTRIES WHICH CAN BE ADDEDl 
496 AVERAGE FILENAME LENGTH OF 10 
1BJ AVERAGE FILENAME LENGTH OF 30 

***** DATA ***** 

103744 BYTES FREE 
27329 BYTES USED 

75 AVERAGE FILENAME LENGTH 
FILES WHICH CAN BE ADDED: 
1621 AVERAGE FILE LENGTH OF 64 
405 AVERAGE FILE LENGTH OF 256 
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DELETE *\ F»rf=»F*«l-IETEF* FILE 
CD] DELETE FILE 

Primng the 'D' key mil allow you to dalata a »inglt file from the 
parameter disk. Salact a file to dalata in tha km way that you would 
■alact a file to load (damcribad earlier) and press tha RETURN key. Tha 
ft la will ba removed from the parameter disk and the apace it used 
reclaimed. 

INITIALIZE F»**F*«I-1ETEF* DISKETTE 

til INITIALIZE PARHDISK 



Pressing the *!' key from the text editor menu will allow you to format 
and initialize an empty parameter diskette to store additional (lie*. 
WARNING: This function erases all data on the target diskette. Enter a 
volume name (or the diskette. When prompted with "FORMAT?", enter "Y" if 
you wish the diskette to be formatted or "N" if the diskette is already 
formatted with standard 16 sectors per track. Press the space bar when 
prompted, to start the format and initialization process. 

After the process is complete, you may use tha disk to save additional 
parameters. 



EIMTEF* THE TEXT EDITOR 



Cfc 1 ENTER EDITOR 



Pressing the 'E' key will enter the text editor. To exit from the text 
editor and return to the text editor menu, press the ESC key. 

If residue exists in the work *rm» t you can clear it by pressing control -N 
(NEW) from tha text editor or exit tha text editor (press ESC) and enter 
'N' (NEW) from the text editor menu. 



USING THE TEXT EDITOR 

The text editor is a line numbered editor. All lines entered Arm given 
sequential line numbers, which are displayed in Inverse text on the 
leftmost two positions of each line. The line numbers *ra displayed in 
hex. Line numbers *ra used only for referring to a portion of a file with 
the ".I" (include) directive of LPL. 
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Lint* in tht tt*t tditnr art displayed ont lint of tt*t ptr ont lint of 
tht Applw 40 rolumn display With / potltlom uttd * or lint nuMbtr , 38 

po*l t i tin* *r t all owed f or tht m#w i mum 1 tnglh ol • ttx t 1 l nt. If it l ■ 
net tssar y to r ont i nut an L PL mt at tmtnt on tht ntx t lint, kty a •inui * i gn 
*"-**) a* tht last character tnt »r td on tht 1 i nt to bt coot i nutd . Any 
numbtr of lint* may thtrtfort bt uttd to contain an LPL ttattmtnt . 

Thprp ^rm two rurtor* uttd In tht ttxt tditor. If tht lint numbtr it 
'lathing, tht cur tor i « on tht I i nt numbtr . If a tinglt charac t tr on tht 
lint i* flashing, tht ciirtor l* mi thin tht ll nt Of ttwt. Thi* i * 
i mpor t ant for tht 1 nstr t and dtl tt t f unc t l on* Mhi ch ^rm dttcr i btd 1 at tr . 

To ent er t fx t , « i mp ly type tht *t at tmtnt * you wi *h foil nwtd by tht RFTURN 
*«y. Tht rtturn ley c aunt* t ht cur tor to go to tht ntxt lint. Tht 
harbspart key <ltft at r nwl i * uttd to bac hup tht cunor ont char ac t »r 
pn*i t i or* i* it i« within a lint of ttx t and tovt up ont 1 i nt if t ht curtor 
i s on a 1 int numbtr . 

Tn td it *n twitting lint, u«t tht RETURN kty or tht 1 tf t arrow to poti t l on 

t ht f ur tor on t ht 1 l nt numbtr of tht 1 l nt to bt td l ttd, and u*t tht 

r i gh t at r ow t o movt tht i ur *or onto tht t tx t lint. Si mp 1 y kty ovtr dat a 
or* tht lint to change 1 ht data. 

To initrt or dtlttt characttr* on t ht 1 I nm, po* i t i on tht cunor within tht 
1 1 nt ovtr tht tharacttr you wi »h to dtlttt or 1 nttrt btfort, and prtt* tht 
r ont r ol I kty to initrt bl *nkt or tht control -D kty to dtl tt t char ac t tr *. 

T r> i n*er t or drlrtf tnt l r t 1 l nt* of ttxt, poti t i on tht curtor on tht 
number of tht lint and pre** tht controJ-I kty to inttrt blank lint* or 
the c ont r nl D key to dtlttt lint*. 

To exit from tht ttwt tditor and rtturn to tht ttwt tditor menu, prttt tht 
FSC kt Y . 

A tummar y of tht ttwt td 1 1 or command 1 1 

ESC twit tht ttwt tditor 

ctrl N Nt Ul - c 1 tar workarta 

RFTURN movt* cur*or to tht lint numbtr of tht ntxt lint. 

< -- if tht cursor i * on a lint numbtr, movt* it up ont lint. 

If the ( ur tor is within a lint of ttxt, movt* it Itft ont 
character post t 1 on. 

> movt* tht cur*or ont poti t i on to tht r i ght . 

ctrl -I if tht cur«or i t on a lint numbtr, inttrt* a blank lint. 
If tht curtor i* within a lint of ttwt, Inttrtt a blank 
c har at t tr . 

ctrl-D if tht cur»or i « on a lint numbtr, dtlttt* tht lint. If 

tht Lurior l* within a lint of ttxt, dtlttt* tht characttr. 

lupl thi* arrow kty or ctrl-K movt* tht curtor up ont lint. 
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[down] thi» arrow hey or ctrl -J move the curtor Uuwn on* line. 

SYNTAX CHECK 

EX] SYNTAX CHECK 

Hrttting the 'X' hay will CAutfl th» tewt tile in the work «rt« to be 
*c iiuifcl * or tyntiN vrrori. In dot ng mo, all ".I" nu lutl# ilirucli veb ar e 

ixpandtd , uiuig th* hlei Mh i ch th*y rat *r*nc*. I ' you use .1 c ommands i n 
your text, be iurt to save the file before you iynt*K chtck, btciuti 
hyntiM chic h Milt chang* th* fit* in aemor y . 

A* t *r v>[)indi ng any .1 command m and synt ex chicking t ha rtiult uig LPt 
stat*m*nts, tha message "SYNTAX CHECK SUCCESSFUL" Mill appaar it no errors 
M*r* found. 

If any error* M«r« found, tha t*xt editor is *nt*r*d with t he cursor on 
tha statement that caused the error and the speaker Mill tiaap. No 
checking 11 done beyond the first error that occur*. 

F>R I IN4X A PARAMETER F I L_E 

IP] PRINT FILE 

Pressing the *P' key trom the tent ad it or menu Mill pr j nt th* curr*nt * i le 

in tha Morkaraa. The standard printer slot is used (default of slot 1), 

but may be changed by setting the parameter for the printer slot to a 
di l » er ent vat ue. 

F>F* I IVJX ALL. PARAMETER FILES 

CAJ PRINT ALL FILES 

Pressing the 'A' hey Mill print the entire contents ot tha parameter dish, 
one tile at a time, in alphabetical order. 
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U*.i/t ' s flanua 1 



»-c**rt r:**H<L> urn intb 
ih ) ramlrd ut il 

Pr ess i rig ' R' from t hf Lock sal t h nil n ntnu Mill di mpl ay the RAM cird 

u( i 1 i t i es ntnu . 



All NAM i anli * oumj in slot* through 7 on th» Appl * *rc di sp 1 a yard al ong 
with the amount of Minor y orach contains. Appl* //* and Appl* //c have an 
internal 16K of avaur y which appear a as slot although no physical slot 
actually exists. Auxiliary memory, found on the Apple //e and built in on 
the App It* //c, is not t est ed by this utility at this ti me. An upgr aded 
RAM c ar d test utility Mill incl ude test s for «ux 1 1 I ar y memor y for the 
App It* / /e and App 1 e / / c . 

ben eat h the SLOT RAM display *rm sever a 1 menu i t em choices. 

r-c^r-i tzt\Kiy Tt-BT 

Lie 1 ec t i ng 'V Mill perform a RAM card read/Mrite test. If more t h an one 
s I ot i on t dins a RAM c ar d you ar e pr ompted for the slot number . Enter a 
slut number Mh ich c ont a i ns a RAM card. Then select ' b ' or ' L ' to indicate 
whether a basic or an ext ensi ve test shoul d be per f or med . The basic test 
runs 1 .'B times faster than the extensive test but it is not as thorough. 
After selectinq the type of test, specify 'S' or ' C ' for single test or 
lumI i nuoos test. Cont i nuous mode shoul d be sel ec ted f or det ec t i ng 
intermittent errors on the RAM card. 

wti ile the test is running, a message si mi 1 ar to the foil omi ng one i s 
displayed on the screen: 

1 1 ii T OOOB bANr- t> PAuL D6 ALT 

Th i s message shows the sequent lal test number (if in cont i nuous mode ), the 
h <*■■► m.itilier , and page number c ur rent ty being test ed . Memor y pages fr am DO 
I hr ough DL have alternate memory pages, which, when selected, display 
"At I" after the page number. 

The test i an he terminated by pressing the ' ESC ' key , suspended by 
pressing t he spate bar, and t ont inued by pressing the *Rl TURN' key. Like 
all t oc ksmith functions, the results can be pri nt ed by pressing c ontr ol 1 . 

If an/ errors were found, »n error message similar to the following one is 
d i sp 1 ayed . 

♦ 1 RRUR WRIT INli AA<2A> AT rtBl ON BANK 1 

T he message shows the test sequent e number , t he bank number , the address 
of trie error, what was wr i 1 1 en and what was read back in paren thesis. If 
any (it her aildr esses in the bank of memory changed values spontaneously 
<Mh lie other 1 oc at l om of the bank war e be l ng Mr 1 1 1 en > , they Mill be 
list ed a 1 so, wi t h t he pr ef i x " + " on the error message . 

lite ext ens i ve test writes each of the 2"5h possible values to each of the 
1 in a I i oris of t tie RAM card, and then reads back the same 1 oc at i on to 1 nsur a 
that t he value was i ndeed st or ed correctly. It al so checks all other 
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I or at l on* of the RAM card to mafc e »urf that no other location* we' • 

mod I < l trl . The basic t es.t i * H'» liAf Jim th* e* t urn iv| t e*t , pm ept that 

intttad of alt pottiblt *">6 valutft, it use* t wo test vahiPi ("^"i and AA) . 

I f any prrwi wer e t ound, you nay want t o consu It t he NAM t ar d manna I t o 
dtttrainf th» 1 ox at 1 on of the faulty RAM chips, or take tht RAM card in 
♦ or ser vl c I ng . 



IJf-l^ RAM CZ#*>F*t> TO Mf'MORV 



Sel ictmg * D ' f r om the RAM card mnu Mill all om you t o dump the c ont pnt m 
of tht RAM card, loK at a t i me t into nam memor v , sn that it car* be 
• m ami ned . The loi Ismifh disk and mtfflor y edl t or ( " N' ' r on the m a l n menu > 

can ha u*a>d to edit the memory. 16k at a time is dumped to main memory 

1 oc a t i on * ?000 to 5F T f a * loll omi i 



l. m<< uw uivn i i ; wu i • i i>v m»mur y . i 

1 ocat i on* ?000 to MM a* * ol 1 om*i 

7000 ?FFF RAM rard page* DO- OF ALT 

VOO-.Vfr' RAM i *r,i page* DO OF 

4000 4* F F RAM card page* HI |F 

500O-5FFF RAM card page* FO-FF 

I * t he RAM card you have *e I ec t ed l * 1 ar ger t han 1 6K , you mi 1 1 he pr ompt ed 
♦ or the bank number . F or a I 2&K card, bank* t r om O to 7 *r e valid. 

UOAO PcOM CARD rRGM MtTMORY 

Pressing 'I* Mill load the RAM card f r om main memor y. Tht* f tmc t I on i * 
the r ever se of the *D* < dump ) func t l on . 1 r>K at a t i me i % I oaded * r om mai n 

memory to the selected bank of the RAM card. 
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SC2AIM DISK 



CQJ SCAN DISK 



This utility Mill help you to determine what track* ere in use on a dimk 
you are trying to copy. 

Pressing 'Q* from the main menu will put you into the scan disk utility. 
This utility is used to determine what tracks on a disk contain valid 
data. You Mill be prompted for the drive number you wish to use and then 
for the starting track, ending track and increment between tracks. 

The display is a hi-res graphic display of the sync bytes on a disk. The 
graphic display of a track runs from the bottom to the top of the screen. 
The first time you run this utility you should do it on a normal DOS 3.3 
disk. First try tracks O to 22 in whole track increments. This Mill shOM 
you what a good track Mill normally look like. The series of dots you see 
on the screen above each track number Arm the gaps of self sync bytes 
between each sector. Normally on a 16 sector disk there will be 16 or 17 
of these dots. This is because Locksmith always reads long enough to read 
the whole track into memory and it may have read more than the whole 
track. Similiarly a 13 sector disk would have 13 or 14 of the little 
dots. On a 16 sector disk one of the dots will be a little longer than 
the others, that is the self sync group in front of sector zero on that 
track. If you look closely you can see a definite pattern to the longer 
dots, they will either move up or down as you move from track to track on 
the disk. This is due to the time it takes to move the disk drive head 
from track to track. 

Now using the same disk try scanning from track .5 to track 22.5 with an 
l nc renter! t of 1 . You will see very 1 ong 1 l nes of whi t ** in no particul Ar 
pattern. This means there is no valid data on the track. If you see some 
evi dence of sectors (short bursts of whi te> , the read head ex per i enced 
"cross-talk" from adjacent half-tracks perhaps (but not necessarily) due 
to a misalignment in either the reading drive or the drive that wrote the 
diskette. 

If the disk is using a protection scheme called spiral tracking you will 
see the long band of white but there will also be a pattern of black in 
between the white. The black sections Mill not be right next to each 
other but Mill be offset slightly as you move across the tracks. This is 
due to the time it takes the disk drive to move from track to track. The 
more that you use the scan disk feature the more valuable you will find 
it. This is because you will become more adept at interpreting the 
resul t s it gi ves you. 
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AUTOMAT I C BOOT TRACER 

I ntt— oduct i on to ABT 

CA] BOOT TRACER 

The Automatic Boot Tracer is intended for use by the more experienced 
Apple programmer. It is actually a sophisticated debugger which can 
simulate the operation of the 6502 in the Apple. Because disk reading is 
simulated, it is possible to actually "boot" a disk (whether protected or 
not) under control of this debugger, and trace the boot code of the 
program. 

Boot tracing, a normally manual and very tedious technique which is used 
by the most sophisticated "hackers", can be performed automatically under 
control of the Locksmith Automatic Boot Tracer. 

To invoke the boot tracer, key 'A' from the main menu. You must have a 
RAM card of at least 16K on your system for ABT to work. If you have ^n 
Apple //e or Apple //c, the "built-in" 16K RAM will work. 

Locksmith ABT will prompt you for the slot number of the RAM card. Key in 
a digit from to 7. 

The ABT will be installed on the RAM card you choose, and the ABT will be 
entered . 

Note that in this manual, the ABT (automatic boot tracer) is also referred 
to as the debugger and the si mul at or, since it actual 1 y si mul ates the 
operation of the 6502, and can be used as a powerful debugger. 

The screen will clear and a line of inverse text will appear on the top 
line of the display. The ABT is now operating. 

If you press reset at any time, you will be placed in the Apple monitor 
and can reboot another disk by entering the slot number followed by 
control-P. Be careful not to reboot a disk which will automatically load 
over the ABT on the RAM card you selected. 

Inf ormat i on L_ ± r~» «s> 

The top line of the screen which appears in i n verse text is a one 1 i ne 
status display which appears initially as follows: 

FA62 CLD A=00 X=0O Y=00 P*=34 S=FD 

The first 4 characters Are the program counter (FA62 in this example). 
The 6502 opcode at the program counter is al so di sp 1 ayed (GLD in this 
example). Next, the values of the A,X, and Y registers are displayed. 
The "P*" value is the processor status register contents, and the "S=" 
value is the stack pointer. 

At this time, press the R key followed by a key from A through X. Notice 
that the information line disappeared and moved to another line of the 
screen. You can put the information line on any line of the screen that 
is convenient for the software you will be debugging / tracing. If you 
don't want the information line displayed, you can place it on row Y or 2 
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(which ara off the screen). 

Idle Mode 

The simulator is in "idle" mode at this time. That is, the program to be 
simulated is not currently running, but is stopped at the address 
displayed by the program counter. 

Press control-C at this time to enable the processing of 65C02 
instructions. This is necessary if you are running on an Apple //c or an 
enhanced Apple //e. 

Press the S key to start exectution under control of the simulator. The 
ABT is now running simulated 6502 code. The simulator is now in "running" 
mode. Note the rapidly changing program counter. The "beep" you hear 
from the speaker may sound a bit different than the Apple "beep" which you 
are used to, but that is only because under control of the simulator it is 
slowed down considerably and sounds lower. 

To stop the program bei ng executed , press C control -Z 3 . You are now agai n 
in "idle" mode. Control -Z is the def aul t character used to stop execut i on 
of the simulated program, but it can be set to a different "stop" key if 
you need to be able to use control-Z with the software you are tracing. 
To change the "stop" key, first stop the program being executed and return 
to "idle" mode by pressing control-Z. Then press control-X followed by 
any other key, and the other key will be used for the "stop" key. 

To reset the "stop" key to control-Z, enter idle mode and press control-X, 
control-Z. 

Enter idle mode. Now press the space bar and watch the information line. 
The space bar is used in idle mode to single-step one instruction. A " + " 
or "-" will appear after each conditional branch instruction, depending on 
whether the branch will be taken ("+"> or will not be taken ("-"). 

while in idle mode, enter control-Y. You are placed in the system 
monitor, and can enter any monitor commands such as "L" (to disassemble 
6502 code). To re-enter the simulator, press control-Y, RETURN. Before 
placing you in the system monitor, the simulator saved low memory pages 00 
to 07 on its RAM card. After re-entering the simulator, this memory was 
"refreshed " , l nsur i ng that no memory was l nadvertent 1 y changed wh i 1 e in 
the system monitor. 

To review the idle made commands we have already learned: 

Space-bar single steps one instruction. It can also be used to 
"single-cycle" (see below). 

"R" moves the information line to rows A through X. 

"8" •tart* th« simulated program running and «nt«r» "running" mode. 

Control-Y enters the system monitor. To re-enter the simulator, press 
control-Y again, followed by the Return key. 

Control-X is used to change the program "stop" key, which stops the 
program and enters idle mode. 
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Other idla mod* commands! 

"T" (traca lubroutin*) axacutas tha simulated program until a JSR or RTS 
instruction is fetched. 

Control-R causas a "simulatad" rasat to occur. Tha program countar is 
fetched -from SFFFC. 

Control -I causas a "simulatad" IRQ intarrupt. 

Control-F turns of* the "simulatad" IRQ panding -flag. 

Control-N causas a "simulatad" NHI intarrupt. 

Control -Q quits tha simulator and returns to tha system monitor. 

Control -RESET also exits the simulator. 

"1" is used to set single-cycle mode. In single-cycle mode, the space bar 
cycles one 6502 processor cycle at a time, instead of an entire 
instruction step. 

"0" is used to set instruction-step mode. It is valid only when on an 
instruction boundary (not on a cycle in the middle of an instruction). 

"B" turns the "beep" flag on and off. The beep is sounded when idle mode 
is entered. 

"C" turns the "click" flag on and off. The click is sounded for every 
keystroke when not in "running" mode. 

Control-C turns the 65C02 flag on and off. The default value for this 
switch is "off". If 65C02 instructions are to be simulated, this flag 
must be on. The Apple //e (enhanced version) and Apple //c both contain 
65C02 processors and use 65C02 instructions in their resident ROM code. 
Nota that tha simulator itself does not use 65C02 instructions. You can 
therefore run 65C02 instructions on a normal 6502 processor. 

"K" will take the next key pressed and place it in the keyboard character 
register. When instruction stepping through code that reads tha keyboard, 
this key allows a convenient way to enter a keystroke to the program being 
traced, without entering the keystroke in "running" mode. 

"ESC" is used to enter the simulator control menu. The simulator control 
menu is used to display and change internal simulator control information. 

Simulator Control Window 

Press the "ESC" key while in Idle mode. The simulator control window is 
displayed, and the cursor appears in the upper left of the window. 

Usa the RETURN key, and the left and right arrow keys to move the cursor 
around the simulator control window. These kays only move the cursor and 
do not change any information in the window. To change data anywhere in 
the window, simply position the cursor over the value to change and 
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re-enter the desired value. To exit -from the simulator control window and 
return to idle mode, press the ESC key again. If you wish to cancel any 
changes made in the simulator control window, you may press control ~C 
instead. 

Let's look at the simulator control window in detail. 

The top line looks very much like the information line in idle mode, 
except that the program counter appears further to the right and no 
instruction is disassembled on the line. The number on the left of the 
line is used for single-byte reading, single-byte writing, and memory 
editing. Enter an address value followed by 'R' to read, *W to write 
(also specify value to write), and 'E* to edit, using the memory edit 
wi ndow. 

To change display modes for the simulated program (text, graphics, hi-res, 
low-res, pagel, page2, fullscreen, mixed), key in the address to toggle 
(*C050-*C057) and enter 'R*. When tracing a program in graphics mode, it 
i s useful to put the i n for mat i on 1 i ne on rows U, V, W, or X , and toggl e 
mixed mode graphics. The simulator will display the information line on 
either text page 1 or 2, whichever is selected by the program being 
si mul ated. 

Enter an address , foil owed by ' E' to enter the memory edi t window. 

While in the memory edit window, the memory is displayed in both hex and 
ASCII text. The cursor can be moved with the RETURN key and arrow keys. 
To change data, si mpl y key in a new val ue in the appropr l ate address. The 
ESC key returns to the si mul at or control window, saving all changes to 
memory. If the changes made in the memory edi t window are not to be 
made, enter control-C. 

The second line of the simulator control window contains: 

RU=65 0=1 1=1 2=1 3=S 4=1 5=1 6=D 7=1 

"RU=65" This value (decimal 101), the "register update" value, represents 
the number of i n struct l ons that Are si mul ated before the regi sters and 
program counter are updated on the screen, when in "running" mode. If 
this number is set small (01 for example), the registers will be updated 
after every instruct i on. This however causes the simulator to run less 
efficiently, because of the overhead involved in updating the information 
1 ine. 

E3X cat Spe?cz x -F ± cati ons 

The rest of the second line displays the slot numbers and how they are to 
be used . Because the si mul at or resides on a RAM board ( i ndi cated by * S' 
i n the si ot di spl ay , for "SYSTEM" ) , it must know about al 1 other RAM 
boards and firmware boards if it is to correctly simulate their operation. 
Initially, the slots will be set to 'I' (invalid). Any reference by the 
simulated program to these invalid slots will cause the simulated program 
to stop and control is passed to idle mode. Valid slot specification 
values Are: 

* S' system (si mul at or ) slot 

'I * l nval i d 
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'D' floppy disk drive 

'A' RAM card of 16K or 32K. 

*B* RAM card of 64K or more. 

*F* Firmware card or ROM card. 

* T* transparent . 

If the specification for a slot is "transparent", any commands for the 
device in that slot will be given without any checking or conversion by 
the simul a tor . Transparent mode shoul d not be used for : 

Any devices such as RAM and ROM cards that bank select memory into 
the address range D000 to FFFF, which is used by the simulator. 

Any devices such as disk drives which are timing dependent, as the 
simulator runs much slower than the 6502 in native mode. 

Any devices which may use DMA (direct memory access) to modify memory 
from addresses *0000 to *07FF, as this memory is used by the 
simulator with a copy of the user's memory actually residing on the 
simulator's RAM board. 



^ddt—esss Compair-e Stop 

The third line of the simulator control window starting with "PC" is the 
"PC compare stop " line. Up to four program counter val ues for "compare 
stop" can be spec i f i ed. If the si mul ated program' s PC equal s one of these 
values, the simulator immediately enters idle mode. In addition, one "PC 
compare stop range" can be spec i f i ed. To enter program counter stop 
values or a range, change the number (initially "0") to the number of stop 
addresses to be entered and then enter the addresses in the space 
provided. To disable PC compare stop, set the number back to "0". 

The "MR" line of the simulator control window is the "memory read address 
compare stop " line. Like the "PC compare stop " line, up to f our addresses 
and one range can be speci f i ed . Whenever the si mul ated program attempts 
to read one of these addresses, ei ther by di rect addressing, indirect 
addressing or stack fetch, the simulat6r enters idle mode. 

The "MW" line of the simulator control window is the "memory write address 
compare stop " line. Idle mode i s entered whenever the si mul ated program 
attempts to write to one of the addresses specified here. 

Program Counter Swap 

The "PCSW" area of the simulator control window is the "program counter 
swap" control area. Up to four address pairs can be specified here. If 
the simulated program's PC equals the first value of a pair, the PC is 
immediately set to the second value, and execution continues. This is 
very useful for eliminating slow timing loops, which are unnecessary in 
the simulator. Initially, 3 pairs of PCSW values are given. They are: 

Locksmith 6.0 Page 44 User's Manual 



FCA8 FCB3 - This nullifies the monitor wait routine. 

BAOO BA10 - This nullifies the DOS 3.3 seek delay routine. 

BD9E BDAB - This nullifies the DOS 3.3 motor-on wait routine. 

Pr-ograim C C3 u n t e* i— Trade Ta\bl e 

The bottom eight lines of the simulator control window contain the PC 
trace table. The last 64 values of the program counter are kept here, so 
that when the simulated program is halted, a history of the last 64 
instructions can be examined. 

F 3 " r~ o q r~ a m Hal ts 

A program running under control of the simulator halts and the simulator 
enters idle mode whenever one of the following conditions is met: 

The "stop" key is pressed by the user. 

An invalid 6502 or 65C02 opcode is encountered. "777" i s displayed 
in the information line where the opcode is normally displayed. 

A JSR or RTS instruction is fetched while running with the "T" 
(trace) command. 

A read or write to the device select addresses of a slot marked as 
"I" (invalid) in the slot table. 

A compare stop occurs for PC, MR, or MW, while running. 

An attempt is made to write to the floppy disk. 

An attempt is made to reference certain I/O addresses. Among these 
are *C060 and *C06B for either read or write. 

Note that in the case of a compare stop for MR or MW or an invalid device 
select reference, that idle mode is entered with the PC containing the 
address of the instruction <after> the one that caused the compare stop. 
Look at the last address in the trace table to find the correct address. 

Internal Operational Notes 

A few notes on the internal operation of the boot tracer / simulator / 

debugger : 

Floppy disk reading is simulated by reading in an entire track of nibbles 
and passing them one at a time to the simulated program requesting them. 
Each time the simulated program requests a nibble, the next nibble in the 
buffer is returned. The simulated program never has to wait for a nibble 
by polling the high-order bit of the disk register. Because of this, 
framing bit timing is not preserved. In addition, the track is not 
synchronized to any other track upon reading. Floppy disk writing is not 
supported . 
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When reading a -floppy disk, the simulator maintains the nibbles of the 
most current track on the simulator's system RAM card. This track image 
is val i d unt i 1 ei ther the si ot or dr 1 ve number i s changed or resel ected, 
or the read/write head is stepped to a different track. Only if the 
current track image is invalid will the real f 1 oppy di sk be read agai n . 
Therefore, if the user performs a "CATALOG" operat i on whi 1 e under control 
of the simulator and then changes the diskette and performs another 
"CATALOG" operation, the catalog information from the first disk will 
st i 11 be di spl ayed because the catal og ( 1 ocated ent i rel y on track * 1 1 ) did 
not cause the head to change tracks and invalidate the track buffer. To 
manually invalidate the track buffer, change the slot specification to 'I' 
and back to *D* while in the simulator control window. 

The simulator has code for "sector assist" built-in. This means that when 
the simulated program requests a nibble followed immediately by testing 
for disk register ready and a compare for *D5, the simulator immediately 
finds the next *D5 in the track buffer and returns it to the simulated 
program, instead of requiring the program to ignore each nibble until the 
value *D5 is found. 

The paddle I/O addresses <*C064-*C067 and *C06C-*C06F> are correctly 
simulated if the code that accesses the I/O addresses is similar to the 
monitor routine at *FBlE (PREAD) . If the reference is not similar to the 
moni tor rout ine, idle mode will be entered. 
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CERT I F^ V E> I SKETTE 

£C3 CERTIFY DSK 

The dii.l> certify function of Locksmith is invoked by pressing *C* from the 
main menu. It can be used to check a diskette for physical damage prior 
to use. 

THIS UTILITY DESTROYS DATA ON THE TARGET DISK. 

Enter the output drive number, the starting track, ending track, and track 
l ncr ement . Inser t the diskette you wish to test, and press the space bar 
in response to the prompt to insert the diskette. 

This f uric 1 1 an works by wr 1 1 1 ng a spec 1 f 1 c pat tern of ni bbl es onto every 
track you specified. It then reads this pattern back to verify that it 
can read what was written. If Locksmith is unable to read what it wrote, 
it Mill flag the track as bad. There can be three di f f er ent reasons for 
the track being fl ayged as bad. First it may not have been wr 1 t ten 
correct ly due to a disk drive mal f unct 1 on . Second 1 1 may not read 
correctly due to a disk dr 1 ve mal f unc 1 1 on. Thi r d and most likely the disk 
med 1a is quest 1 on<*b 1 e, espec tally if several adjacent tracks di sp lay 
er r or s. 

Ml i en Lot ksmith checks the disk it will wr 1 1 e a per l od (.) in the status 
area i or every track that checks good. If a track checks bad it will be 
flagged with an aster l sk (*). 
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16 SECTOR UTILITIES 

This function gives you accm to uviril utilities designed to work with 
normal 16 aactor (ganarally unprotactad) disks. Thasa can ba DOS 3.3, 
PRQDQS, CP/M, or any standard 16-sector disk. 

To invoka any of tha 16-sactor utilitiaa, first praas "U' from tha main 
nana. 

±£> SECTOR DISK VERIEY 

CV] 16 SECTOR FAST DISK VERIFY 

Prassing 'V from this submenu will taka you to tha FAST DISK VERIFY 

utility. You will ba prompted for tha driva number of tha disk you wish 

to verify. Locksmith Mill than proceed to read tha disk from track to 
track «22. 

On the status display at tha top of the screen, a period '.' means the 
track read correctly. An asterisk '*' means tha track did not read 
correctly. A number represents the number of extra times the disk had to 
spin to read all sectors correctly. A number 'I' for example means the 
track had to be reread once in order to read correctly. 

Below the status display is the track/sector display. On tha track/sector 
display the symbols have the following meaningi 

A period '.' means the sector was read correctly on the first disk 

revolution. 

An Inverse character 'A' means there was something wrong with the address 

field or the address field was missing. 

An inverse character 'D' means there waa something wrong with the data 

field. 

A number indicates that the sector was read correctly, but that it took 
several rereads to read it correctly. 

1 «S» SECTOR EORM^T 

CFJ 16 SECTOR FORMAT 

Pressing 'F* will allow you to format a disk. This utility will format a 
disk or a range of tracks with the volume number you specify. This could 
be very useful if a track had been destroyed accidantly. In this case the 
disk would normally be unusable. However with this utility you could 
simply reformat the one track and use the disk. 

THIS FUNCTION WILL NOT RECOVER DATA THAT MAS ON THE DESTROYED TRACK. 

You will first be prompted for the disk drive you wish to use. Press 
either '1' or '2', depending on which drive you wish to use. You will 
then be prompted for track start, end and increment. Specify the tracka 
you wish reformatted. You will next be prompted for Volume Number. 
Specify the volume number that you wish to format in the Address Field. 
Following the Volume Number, you will be asked which Track Numbers to use. 
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Normally, the defaults Mill be used. Since it is possible that you may at 
some t i me mi sh to use a non-standard f or mat , this is left up to the user. 
For example, some protected disks currently on the market use tracks *06.5 
through *22.5. These tracks are formatted with track numbers *06 through 
»22. 

1 <£» SECTOR DISK C O M R" ^ R EI 

CC3 16 SECTOR COMPARE 

Pressing a "C" from this submenu Mill allow you to compare two disks for 
differences. When you select this option you will be asked for the drive 
number of the disk you wi sh to compare. Thi s rout ine stores a doubl e-byt e 

(16-bit) (heck sum for each sector in memory and compares it to the one 
alre.-.1y there. If they don't match you will get a 'C on the sector 
number display. When reading the first disk to compare, it is normal to 
get many * compare errors* because incorrect sector checksums ^ra initially 

in memory. 

After the disk you wish to compare l s read into memor y , take it out of the 
dr l ve arid repl ace it with the disk you wi sh to compar e to. Pre^s the 
space bar to begin compare, and any sector that matches will have a period 
' . ' on the sector di spl ay for that sector . I f a sector doesn ' t match 
there will be a letter * C* on the sector display. The checksums that were 
there f r om the original disk have now been rep 1 aced by those of the disk 
you just compared , so if you pressed the space bar agai n wi thout remov iny 
the disk just compared you shoul d get all per i ods ' . * on the sec t or 
display. In additi on to the *.' and ' C* , you may also find inverse 'A' 
and inverse *D'. These indicate address field and data field errors, 
respect l vel y . 

1 <£> SECTOR BYNC S I G» M *=* T LJ R E 

[S3 16 SECTOR SYNC SIGNATURE 

This utility is used to obtai nasi gnature of the sync pat tern on a normal 
16 sec tor disk. Thi s can be useful when work i ng on synch ram z ed di sks. 
You will be prompted for the disk drive you wi sh to use. Enter either ' 1 ' 
or ' 2' . Tin s routine starts at track *00 sector *00. Af ter reading thi s 
sector, it moves to track 1, and displays the first sector number that it 
encounters. This continues until all *22 tracks have been checked. 

The sync signature is displ ayed agai n and again. It may be slightly 
different due to disk speed varaiations from time to time. To terminate 
the sync si gnature rout l ne, press ESC. 

In add i t i on to checking synchroni z at i on , this routine can be used to 
deter mine what copy progr am cr eated a given 16 sector diskette. 

A sync signature on <* 16-sector diskette will normally show a progression 
of hi ex numbers , either ascending or descending. For e;< ampl e, the 
foil owi ng pr ogressi on shows hex numbers descendi ng by one: 

0FEDCBA9876^4321OFEDCBA9876543210FE 

We will identify the above progression as (-1), to indicate that each hex 
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digit is one less than the one before. The following table shows several 
copy programs, and the progression identifier that identifies trie sync 
signature for a disK which was created by that specific copy program. 
Note that simply writing data to a disk will not change its sync signature 
- the disk must actually be formatted or generated by a copy program that 
formats the disk. 

Program signature i dent 1 f i er 

DOS INIT 0DA741EB85. . . (-3) 

Loc ksmi th 
Format 04BC048C... (+4) 

Lock smi t h 
Fast Backup 0FEDCBA987. . . (-1) 

Penulta Copy 0ECA8 (-2) 

CopyWr l ter 

(no verify) 0000000. .. . (+0) 

CopyWr l ter 
(verify) 0FEDCBA987. . . (-1) 

Disk Muncher 0DB52FC964. . . (»*) 

Pack Rat 0DB5&30DA5 <«*) 

Note that the signatures will have the same progression throughout the 
signature only if the disk was recorded in a single pass without turning 
the drive off between tracks. For example, the following signature wab 
generated by Locksmith FAST DISK BACKUP in a single pass copy (with 12BK 
RAM board) : 

0FEDCBA9B76543210FEDCBA987&543210FE 

Nute that each hex digit is one less than the previous digit. This i^ in 
^^r eemen t with the table shown above. Now cofflpar e the foil owi rig 
si gnat ur e; 

0FEDC&A9873210FEDC&A6543210FED98765 

Note that the progressi on is the same (-1), except that at 3 places 
(identified by arr ows bel ow the signature), where the progr essi on i -=> ( -4 ) . 
Th l s is because this signature is fr om a disk that was created by 
Locksmith FAST DISK BACKUP running without RAM cards. Notice that every 
10 tracks, a break in the progression occurs. This is because withoi.it RAM 
cards, FAST DISK BACKUP copies 10 tracks at a time, and then I ead* t tie 
or lginal disl again. So on I y groups of 10 tracts remain in sync with each 
other. Inci dent ally, the break in the progressi on was (-4). If the di sk 
was created by Locksmith FAST DISK BACKUP with verify after write, the 
break in the progr essi on woul d have been ( -3) . As you can see, a lot c an 
be deter mi ned about a disk using sync signature. 
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DOS 3.3 UTILITIE8 

CD] D0S3.3 UTIL 

Pressing the ' D' key «nt»n tha DOS 3.3 utilitiaa uitnu. Salact any option 
from this menu and you will be prompted -for the Input drive to use. The 
input drive will also be used to rewrite data, if the function requires. 

CATAUOS DISK 

Pressing 'C* from the DOS 3.3 utilities menu will display the catalog of 
the disk in the current drive. Deleted files Arm marked with a "D" in the 
front of the file name. 

l_OAD DOS FILE INTO MEMORY 

Pressing the 'L' key will allow you to load a DOS file into memory for 
editing with the disk editor. After answering the prompt for the 
filename, the file is read into memory from »2000 to «7EFF. The TSL 
(track / sector list) is placed in memory at S7F00, so that the file can 
be rewritten to disk from the disk editor. 

SHOW D I SK SRrtCE M«R 

Pressing the *M' key will display a disk space map on the screen. The 
sectors Ara displayed down the left and right sides of the screen. Free 
sectors Arm indicated by "-" and used sectors Arm indicated by "#". Press 
the space bar to enter the utilities menu. 

FIX SECTOR COUNTS 

Due to errors within DOS 3.3, the sector count of a file in the catalog 
sometimes gets set incorrectly, usually to zero. Pressing 'K' from the 
DOS 3.3 utilities menu will allow you to automatically correct the sector 
counts on the disk. The sectors for each file Arm counted and compared to 
the information in the catalog. If the counts Arm not equal, the filename 
and the counts Are displayed and you Arm prompted to press the space bar 
to correct the sector count for the file. Press the space bar to correct 
the sector count for the file or press the ESC key to abort the function. 

VERIFY VTOC INTEGRITY 

The VTOC (volume table of contents) is a bit-map of the free sectors of 
the disk volume. The catalog is a list of names, each with a chain of one 
or more TSLs (track/sector lists) which define the rest of the sectors in 
the file. If a user's program fails while files Arm open for output and 
they are not properly closed, the VTOC and catalog can get out of step. 

Pressing 'V* from the DOS 3.3 utilities menu will perform a VTOC/catalog 
integrity verification. The display will appear much like the disk space 
map display (function 'M') and contain both "-" (free sectors) and "#" 
(used sectors). In addition, 3 types of errors are detected and 
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di spl ayed: 

Sectors which are allocated in the bit map but not used in any files are 
displayed with an inverse "A" (allocated, not used). 

Sectors which are used in a -file but not allocated are displayed with an 
inverse "U" (used, not allocated). This is a critical situation because 
the file data o-f the affected file can be overwritten if another file is 
allocated over it. If this situation occurs, do not use this disk. 
Immediately copy the files to a blank disk using the FID utility found on 
the system master diskette. 

Sectors which are allocated to more than one file at a time are displayed 
with an i n verse "2" (2 files all oca ted ) or an i n verse "3", etc. This 
si tuat l on l ndi cat es that one of the fil es overwrote the other one. You 
should copy the files to a blank disk using the FID utility found on the 
system master diskette. 

REMOVE DOS FROM DISK 

Pressi ng the ' R' key will all ow you to remove the DOS boot code from the 
disk, freeing up 32 more sectors. Note that only tracks 1 and 2 (16 
sectors each) are freed. Track could be freed but DOS is unable to 
all oc ate fil es on track zero even if it is marked free. 

A disk space map is displayed. After pressing the space bar, DOS is 

removed from the diskette, the VTOC is rewritten, and a disk space map is 

again displayed. You will notice that tracks 1 and 2 now contain free 
sectors. 

UN-DELETE A FILE 

Pressing the 'LT key from the DOS 3.3 utilities menu will allow you to 
un-delete a file whi ch was previ ousl y del eted. Enter the fil ename when 
prompted. If the filename cannot be found, an error message will be 
displayed. If the file has not been overwritten by another file, it will 
be un-deleted and returned to the catalog. If the file has already been 
overwritten by another file, a message will be displayed and the undelete 
will be aborted. Press the space bar to return to the utilities menu. 

ALPHABET I ZE CATALOG 

Pressing the *A* key will allow you to alphabetize the filenames in the 
catalog. After the names have been read into memory and sorted, you wi 1 1 
be prompted to press the space bar to allow the alphabetized catalog to be 
written back to the diskette. 

ENCRYPT A EILE 

After pressing the *E* key (encrypt file), you will be asked to supply the 
name of a file to encrypt. The catalog is checked to verify that the file 
exists. You are then asked to supply a password for the encryption. The 
password you enter will not be displayed on the screen, but you will need 
to enter the password again to verify that you entered it correctly. 
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If both password entries are identical, the -file is encrypted using the 
password you supplied. Do not forget the password - it is the only way to 
decrypt this file. If the encrypted file is displayed, it will appear as 
meaningless garbage. If the password is forgotten, the file will probably 
remai n that way forever . 

DECRYPT F" I l_EI 

Pressing *D' from the DOS 3.3 utilities menu will perform a file 
decryption function. This is the opposite of the encryption function 
described above. The procedures are the same as the ones for encryption 
of a file. If you decrypt using the wrong password, the file will remain 
as meaningless garbage. 

Note that if a file is encrypted twice (perhaps by two individuals, each 
entering their own password), that the decryption should be done in the 
rever se order . For ex amp 1 e, if a file is encrypted first with password 
"LOCK" and then with password "SMITH", the order for proper decryption is 
first with the password "SMITH" and then with "LOCK". 

After data is encrypted, it should be backed up. This is because if an 
attempt is made to decrypt the file with the wrong password, the file is 
scr ambl ed more. To reverse a decrypti on in error , perform the encrypt 1 on 
usi ng the same password, and vice versa . 
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ADVANCED DISK RECOVERY 

CXI DSK RECOVER 

When you notice a problem with your disk drive which causes disk I/O 
errors, either on a permanent or intermittent basis, it's best to have 
your dr 1 ve checked . 

What if you have important data which you've backed up using the 
mis-aligned or -faulty drive? 

Locksmith Advanced Disk Recovery (ADR) wi 1 1 recover data which cannot be 
read from a diskette due to one of three problems: track mis-alignment, 
of f -center hub cl ampi ng, and i mp roper disk speed. 

Proper track alignment is more critical than disk speed when reading and 
writing data to a diskette. While disk speed, once set, usually remains 
constant; track alignment, because it is affected by normal mechanical 
wear of the drive mechanism, can change with time. 

While disk drive track alignment should only be attempted by a qualified 
technician, there are some warning signs that indicate improper track 
alignment of your disk drive. Track mis-alignment should be suspected if 
data which was written on a specific disk drive is difficult or impossible 
to read using a different disk drive. This symptom does not indicate 
which drive is mis-aligned, but merely that an i ncompat i bi t y exists 
between the two drives. Sometimes the mis-alignment problem is compounded 
because the writing and reading disk drives are mis-aligned in the 
opposite direction. For example the writing drive may record a track 1/4 
track too low and the reading drive may attempt to read the track 1/4 
track too high. The resulting difference of 1/2 of a track is enough to 
make the data impossible to read. Even if the reading drive alignment is 
correct, the resulting difference of 1/4 track is enough to make the data 
read unrel l ably , especial ly an the inner tracks of the diskette (higher 
track numbers) where the data density is greater. 

While track alignment problems usually manifest themselves gradually over 
time, a problem due to off-center hub clamping (more common on older 
drives or diskettes without hub rings) is usually quite sudden and severe. 
When the disk drive door is closed, the hub clamps down on the center hole 
of the diskette. If the media is slightly off-center when the door is 
closed, it is usually centered as the hub clamps it into position. 
Sometimes the diskette is clamped off-center. If this is done before 
reading a diskette, the resulting abnormal head-seek noise is usually 
noticed and simply opening and closing the drive door will re-center the 
diskette properly. If, however, the diskette is clamped off-center prior 
to formatting and writing, the diskette will be formatted and written with 
no adverse symptoms. The data on the diskette can even be read and 
verified, however, once the diskette is removed, the data will be 
unreadable because it was written with the diskette off-center. Any 
attempt to read this off-center diskette will fail. 

Writing sectors to a diskette on a drive which is running too fast can 
cause the following sector's address field to be over-written. Although 
the data field of the sector is intact, the missing address field will 
cause an I/O error when attempting to read the sector. 

Locksmith Advanced Disk Recovery will recaw&r the data from a diskette 
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recorded ei ther off -center , wi th bad track all gnment , or with missing 
sector address fields, and write the data to a blank formatted disk. You 
muit previously format the disk upon which you wish to place th« recovered 
data. (You may use the Locksmith 16-sector disk format utility to do 
this. ) 

Specify the source and target drive numbers and the starting and ending 
track numbers (usually 00 to 22) and Locksmith Advanced Disk Recovery will 
read the problem disk on the integral as well as half-tracks and 
quarter -tracks as needed to recover the data sector by sector . If you 
wish to perform a test run to determine if Locksmith ADR can recover the 
data wi thaut actual ly writing the recovered data, spec lfy a target dr i ve 
number of zero. Si;< tracks a^re processed at a ti me. The recovered data 
is wr 1 1 ten to the target disk, unless zero was spec i f i ed for the target 
disk drive, in which case no writing of recovered data is performed. 

The track status display area at the top of the screen shows the status of 
writing the data to the target disk. The bottom part of the screen is 
used as the sector status display. The numbers appearing in i n verse text 
down the left and right sides of the sector status area are the sector 
numbers for each track. The order of the sectors in the sector status 
area is the same as the sector order on the track (0,7,E,6,D,...). A 
single status character is placed in the sector status area for each 
sector to indicate the status of the sector read: 

A per l od (.) indicates that the sector was read from the correct track 
with no errors . 

An ( i n verse A) indicates that the address field for the sector was never 
f ound . 

An (inverse D) indicates that the address field was found but the data 
field was not read correct 1 y . 

A plus sign (+) indicates that the sector was correctly read from a higher 
track, half-track, or quarter track. 

A minus sign <-> indicates that the sector was correctly read from a lower 
track, half-track, or quarter track . 

A semicolon (;) indicates that the sector was missing an address field, 
but that this problem was corrected. 

Note that only the <inverse-A) or (inverse-D) indicate an unrecoverable 

error . 

The foil owing figure shows a sample screen after Advanced Di sk Recovery 
has recovered data from an off -center disk: 
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DSK RECOVER 
.00 
.25 
.50 
.75 

HE X OOOOOOOOOOOOOOOO 1111111111111111 0000 
TRK 0123456789ABCDEF0123456789ABCDEF0123 

o++ — . +. ~. +.-+. — . +. -.+. — +. — +. — +. ~0 

7+. — ++ — . +-. + . - + + — , +. -. +. — +. -. +. -7 
E+. -.+. -. ++-.+-. +. — . + — . +. -. + — . + — E 
6+. -. +. -. +. -. + -. +. -. +. — . + — . . — . + — 6 
D+ — . +.-.+.—+. -.+.-.+.-.+. — . . — +. --D 
5. — ++ — ++. -+. -++ — . +. -. +.— . +. -. +. --5 
C. -.+.-. ++--+. -+. --. + — . +.-.+--. +. -.C 
4.-. +.-. +.-.+-.+.-.+. — . + — . +--.+- - . 4 
BD- + + .-.+.-.+-.+.-.+.—.+. — . + — +. — + B 
3A. ++ — ++. — • . -. + — .+.-. +. -. +. -. +. --+3 
AA. + .-. ++ — +. -+. — +. — •+.-.+.*-.+ — . +A 
2A.+.-. +.-.+.-+.-.+. — +. — .+.-..--.+2 
9.++.-.+.-.+-. +.-.+.-.+.--+. -.+. — .+9 
1.++ — ++.-.+-.+ — .+.-.+.-.+.-.+.-.+.1 
8. +. -. + + — ++—. +— . +. — . +. -. +. -. + — , +.0 
F. + . -. +. -. +. -+. -. +. — +. — . + — +. — . +— F 

Note that when the sectors are arranged in the same order in which they 
appear on a track, the plus signs and minus signs an a track appear in 
clusters. This indicates which sectors were found on higher track numbers 
(inward toward the center of the disk) and which were -found on lower track 
numbers (outward toward the edge o-f the disk). 

It is common, when recovering data from an off-center disk, to have some 
sectors on track 00 whi ch coul d not be recovered, because to recover them 
would require reading below track zero, which is physically impossible. 
This is usually not a problem, since DOS does not normally use track 00 
for storing user data. 
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DISK SF-EETD TEIST 

CS] DISK SPEED 

Pressing 'S* from Locksmith's main menu will put you into the disk speed 
utility. Depending on which overlay you have in memory at the time, you 
may be asked to insert your Locksmith disk to load the program. The -first 
question will be which drive number. Then you will be asked which of 
three types of speed check you wish. The first is to calibrate your drive 
to 300 RPM. This is the normal drive speed recommended by the 
manufacturer. 

The second choice is to calibrate your drive to the optimum drive speed. 
This speed is recommended for copying disks, since it runs slightly slower 
than normal. This helps to ensure that an entire track can be written, 
irregardless of the drive speed of the original. 

The third option is to calibrate your drive to the same speed as the drive 
on which the original disk was written. You will be prompted to insert 
your original disk in the drive. This is to allow Locksmith to determine 
the original drive speed. After inserting your Locksmith disk to load an 
overlay, you will then be given three choices for the graph scale. 

You should normally choose fine adjust. The other two options Are for 
disks that are so far out of adjustment that they can't be seen on the 
fine scale. After you choose the type of graph you wish, Locksmith will 
prompt for the number of samples you wish per plot. 

The choices you have on the above menu are used by Locksmith to determine 
how many times to check the speed prior to plotting a point on the hi-res 
screen. Normally you would select one sample per plat. This will check 
the drive speed once for every point it plots on the screen. 

Next you will be asked to insert a blank disk in the drive you selected 
for the speed test. After you press the space bar Locksmith will write 
and read from track zero of the blank disk. You must use a blank disk for 
this test since the data on track zero will be destroyed. 

ERftSE DISK 

[EI ERASE DISK 

This function is used to entirely or partially erase a diskette. 

Pressing *E* from the Locksmith main menu will take you to this utility. 
THIS UTILITY DESTROYS DATA ON THE TARGET DISK. 

You should place the disk you wish to erase in the drive of your choice. 
Locksmith will prompt you for the drive of the target disk, the starting 
track number and the ending track number you wish erased, and the 
increment between tracks. 

After you have specified the above information, Locksmith will prompt you 
to insert the disk to be erased. After pressing the spacebar, Locksmith 
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will proceed to erase the special ed tracks on the disk. 

When the program is -finished erasing the specified tracts, it will return 
you to the main menu. The status area is not cleared. Every track that 
was erased will have an *E* in the status area. 

Some disk protection schemes require that a track never have been used. 
The only way to accomplish this is to use either a new disk or era^e the 
track on a disk which has been previously formatted. 



INSF^EICTOF* / WATSON 

CI] INSPECTOR 

I-f you have previuosly loaded Inspector /Watson onto your RAM card with the 
main menu * L ' (load RAM card) function, booted with a DOS disk that loads 
the Inspector /Watson onto a ram card or i-f you have a f i rmware card with 
these programs on it then pressing 'I* from the main Locksmith menu will 
place you in either the Inspector or Watson . 

The Inspector/Watson program works exactly as documented in the respective 
manuals, with the -following exception. When Inspector /Wat son is given 
control from Locksmith, the default buffer address will be $4000 instead 
of *0800. This is because *0800 is reserved for Locksmith use. 

If you only have the Inspector, control will be passed to the Inspector. 
If you have both the Inspector and Watson then control will be passed to 
Watson . All the normal program commands ar& useabl e, with the except l on 
of the ESC function (see next paragraph). To exit Inspector /Watson press 
* CTRL— C and you will be back i n Locksmi th. 

If your Inspector /Watson resides on a RAM board in slot 0, the ESC key 
will also return you to Locksmith. If your Inspector /Watson is in ROM, 
you must use * CTRL-C to ex i t . 

For information regarding the use of Inspector /Wat son , please refer to 
their respective user's manuals. 
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LOCKSMITH PRQGRAMM X IMCS LANGUAGE 

Locksmith Programming Language <LPL) is a tool which the Locksmith user 
can use to specify how Locksmith is to perform certain functions. With 
it, the user can set up a procedure ta backup a di f f 1 cul t-to-copy disk, 
automat ically search for and change data on a disk, repai r damaged data, 
etc. Almost anything that can be done with Locksmith can be done 
automatically by specifying the proper LPL commands. 

LPL commands, or statements, are collected into a file. This file can be 

entered from the keyboard by the user or may be 1 oaded from a 

spec 1 al -format parameter disk (whi ch is incl uded with your Locksmi th 6.0). 

THE INCLUDE C . I > COMMAND 

LPL f 1 1 es can be saved with their own name on the parameter disk. These 
f i 1 es can ref er to other named LPL files on the parameter disk and can 
include parts of these files or entire named files within them. In this 
way you can use a techni que used i n another file wi thout repeat i ng the LPL 
statement s , si mpl y by ref err ing to the name of the other file. For 
example, if a file call ed "BRQDBUND" exists on the parameter disk, and it 
cental ns LPL statements whi ch you wi sh to use in the current file, use the 
following statement in your LPL file: 

. I BRODBUND 

The ".I" must appear as the first characters on the line, and be followed 
by a space. All of the statements in the named file "BRODBUND" would be 
l nc 1 uded when the file you Are enter ing was expanded by the te;<t edi tor 
dur i ng ei t her a syntax check or backup operat i on . You can save your file 
to the parameter disk either before expansion (to save disk space) or 
after expansion. Included files can, in turn, refer to additional 
included files. If you wish to include part of a file, you can specify 
the starting and ending line numbers after the file name. For example: 

.1 TESTFILE,4-1F 

The above example would include only line numbers 4 through IF from the 
file named "TESTFILE". 

There is no limit to the number of .1 include statements which you can 
use, except that the total number of 1 i nes in the file cannot exceed FF 
(dec l mal 255) . 

Each line entered into the LPL file is given a line number (the line 
number appears to the left of the line in "inverse" characters) . The 1 ine 
number is printed in hexadecimal to save space on the display, but the 
1 i ne numbers ^re not i mpor tant , except when including text from other LPL 
files with the .1 directive. An LPL line can be up to 38 characters long. 
The following is an ex ampl e of an LPL line: 

FIND D5 AA 96 

The above example is an LPL line which consists of a single LPL statement. 
You can enter several statements on a single line by separating them by 
col on s < : ) . For ex ampl e: 
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SLOT 6 i IN. DRIVE 1 : OUT. DRIVE 2 

The spaces before and after each colon are not necessary, but are included 
for easier readability. If a statement is too long for the current line, 
it can be continued onto the next line by coding a "-" as the last 
character on the line. For example: 

DEPOSIT (DF) <F4) <DF> <D4) (FF) - 
D5 AA 96 AA AA 

You may insert remarks or comments into your file at any time to help 
document what you are doing. An asterisk (•) causes the rest of the 
statement to be i gnor ed. Note that the comment is a statement , and that 
any statements following it on the line are evaluated. For example: 

* SET SLOT NUMBER ; SLOT 6 
SLOT 6 : * SET SLOT NUMBER 

Both the above lines are equivalent. Blank lines can be included anywhere 
for ease of readability and are ignored. 

I_F="I_ STATEMENTS 

LPL statements consist of "tokens" which can be thought of as words in a 
sentence. Tokens are separated by blanks. The first tot-en used in a 
statement determines the type of the statement. A token can represent a 
variable name or parameter name, a constant, or a processing routine name. 
Statements can be grouped into the following categories: 

comment or blank line 

statement 1 abel 

assi gnment statement 

processing 

Any statement may have a statement label preceding it. Statement labels 
are optional and are used for branching within the LPL file with the GOTO 
statement. A statement label begins with the keyword "LABEL", and is 
fallowed by a name. Label names can be of any length, and are any 
sequence of alphabetic or numeric characters or the period, with the first 
character being alphabetic. The foil owing are ex amp 1 es using valid 
statement labels: 

LABEL READ. TRACK. AGAIN : 

GOTO READ. TRACK. AGAIN 

LABEL A2. ERROR : PRT "LENGTH ERROR" 
GOTO A2. ERROR 

TYF^ES OF CONSTANTS 

Several types of constants are used within LPL. They are described here, 
with examples of each. 

Single byte constant (hex): 
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D5 
6 

00 
(FF) 
Single byte constants, when enclosed in parenthesis, indicate self-sync. 

Multiple byte constant (hex): 
(FF) D5 AA 96 
00 10 20 30 40 50 60 70 80 

Double byte constant (hex) : 

1A70 

Doub 1 e byte constants usual 1 y represent addresses or 1 engths. 

Track val ue constant (hex ) : 

12.5 

1A.75 

11.0 

0. 

Track value constants cont ai n a dec i mal point. 

Single byte character constant : 

"X" 

' X' 

Note that either single or double quotes can be used. 

Multiple byte character constant : 

"DON'T FDRGET TO COVER THE NOTCH." 

If a quote is to appear in the constant , use the other quote to delimit 

the string. 

Multiple byte constants can consist of a mix of hex and ASCII data: 
89 'GRD' BD 

Special constant: 
•? 

The "?" represent s a "don't care" value, when used in search patterns. 

Flay constants: 

YES 

NO 

ON 

OFF 

These constants are equivalent to and FF, but are preferred because of 

their readability. 

TYF^ETS OF V/^FC I i=kBL_ES 

Var i abl e names used within LPL usual 1 y have a speci fie use for each name, 
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although some yeuer al purpose names have been provided for the user. 
Several types of var lable names are provided within LF'L . They are 
described here, with examples for each. 

Single byte variable: 

SLOT 

IN. DRIVE 

OUT. DRIVE 

Multiple byte pattern/string variable: 

GR. CHARS 

PAT1 

SYNC. PAT 

Pat t»rn/str i ng variables are variable length, and have a one byte length 

as the first byte of the variable. Although pattern/string variables have 

a variable length, each is all owed a maximum 1 ength of 15 (decimal). 

Ml'1 tiple byte variable: 

NIP. TRANS 

SFC. TRANS 

INV. TAB 

These variables refer to multiple-byte areas of memory of fi:.ed length, 

such as loot up tables. Because they are fi*ed length, there is no length 

1 ,te pref i . associated with the variable. 

If you have a need to refer to a byte within a multiple byte variable, you 

can code a plus sign followed by the displacement into the table. For 

e.. ampl e: 

NIB. TRANS + 2F 

Double byte pointer variable: 

START 

I MI) 

TFI . 1 FN 

niFSOR 

F ■ r r- . U 

r-Tp. x 

I IF.Y 
PTR. Z 
Diuible byte puinter variables can also represent lengths. 

Tr c*c I var i abl e: 

BFuIN.TRK 

F ND. TRK 

I NCR. TRK 

SYNC.TRK 

Track variables can represent integral track values, or 1/4, 1/T, or 7/4 

tracks. 

Fl ag var i abl e: 

SYNC 

COUNT 
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SHOW. ADDR 

Flag variables are single byte variables that contain a flag of YES/NO, 
ON/OFF, or FF/O and act as switches which can be set and tested. Values 
other than these may have unpredictable results. 

THE ASSIGNMENT STATEMENT 

The assignment statement is used to assign a value to a variable. The 
variable can be assigned the value of a constant or another variable. 

The variable to be assigned and the variable or constant to which it is 
assigned must be of the same type. For example, a pointer variable can 
only be assigned to another pointer variable or a two-byte value (3 or 4 
hex digits) . 

Borne examples of valid assignment statements ^rez 

START CURSOR 

Set the variable START (start of track data) to CURSOR (current cursor 

1 ocat 1 on ) . 

CURSOR 2040 

Sets the value of CURSOR to point to 2040. 

SLOT 6 

Sets the one-byte variable SLOT to the value 6. 

BEGIN. TRK 12.5 

Sets the track variable BEGIN. TRK to the track value 12.5. 

CUR.TRK SYNC. TRK 

Sets the track variable CUR.TRK to the track variable SYNC. TRK. 

COUNT YES 

Sets the flag variable to the flag value YES. 

PAT4 D5 AA 96 

FAT4 FAT7 

Both of the above string variable assignments are valid. 

CR. CHARS 89 'SRD' 

Sets the string variable GR. CHARS to the 4-byte string consisting of hs;< 

89 (control-T character) fallowed by the ASCII data 'GRD'. 

DF.HDR3 B4 : AF.HDR3 DD 

Thi?be assignment statements set the third data field header byte to B4 

(normally AD) and the third address field header byte to DD (normally 96). 
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AF.TRL1.TEST IGNORE. TRL 

AF.TRL2.TEST IGNORE. TRL 

DF.TRL1.TEST IGNORE. TRL 

DF.TRL2.TEST IGNORE. TRL 

These assignment statements patch RWTS to ignore the trailer nibbles of 

the address field and data field. 

AF. TRL 1. TEST NORM. TRL 1 
AF.TRL2.TEST N0RM.TRL2 
DF. TRL 1. TEST NORM. TRL 1 
DF.TRL2.TEST NORM. TRL2 
These statements patch RWTS back to normal trailer nibble checking. 

AF.CSUM.TEST IGNORE. CSUM 

DF.CSUM.TEST IGNORE. CSUM 

AF.CSUM.TEST NORM. AF. CSUM 

DF.CSUM.TEST NORM. DF. CSUM 

These are used to patch RWTS to ignore or to use the address field and 

data field checl sums. 

AF. CSUM. SEED 00 

DF. CSUM. SEED 00 

These statements set the checksum seed values for RWTS read address field 

and read data field. 

AF.HDR1 D5 

AF.HDR2 AA 

AF.HDR3 96 

AF.TRL1 DE 

AF.TRL2 AA 

DF.HDR1 D5 

DF.HDK2 AA 

DF.HDF3 AD 

DF.TRL1 DE 

DF. TRL2 AA 

These statements set the default header and trailer values for address 

fields and data fields which are used for reading. 

DF.HDR1.WRT D5 

DF.HDR2.WRT A A 

DF.HDR3.WRT AD 

DF.TRL1.WRT DE 

DF.TRL2.WRT AA 

DF. CSUM. SEED. WRT 00 

These statements set the header and trailer nibbles to be used when 

writing a data field. The last statement sets the seed to be used for the 

calculation of the checksum for writing the data field. 



Loci smith 6.0 Page 64 User's Manual 



PROCESSING ROUTINES 

LPL processing routines (referred to as "algorithms" in earlier versions 
of Locksmith) Are routines that the user can invoke on demand using LPL. 
Some of the routines Are complex and are driven by many variables, while 
others Are simple and operate using only one or two variables. Some 
routines use parameters consisting of constants or pointers passed to them 
and some accept no parameters at all. The valid syntax of each processing 
routine is described in an addendum to this manual, but we will describe 
some of the processing routines here and give some examples of their use. 
The Parameter Diskette included with your Locksmith is an excellent source 
of examples for the use of LPL processing routines and variable names. 
You may also wish to refer to a "Quick Reference of LPL Names" in the 
addendum to this manual for a complete list of all variable names and 
processing routine names. 



ABORT "DATA NOT FOUND" 

Aborts the current operation and displays the message on the screen, then 

returns to the main Locksmith menu. 

PAUSE "ENTER 1,2, OR 1 ■: " 

After a key is pressed, the value of the key is placed in the single-byte 

variable KEY. IN 

PRT "DISK MUST BE WRITE/ENABLED" 

Prints the message on the screen. If the last character of the message is 

a blank, the cursor remains on the same line for additional output. 

SHOW SLOT 

Prints the value of the variable name SLOT. If the flag variable 

SHOW.ADDR is YES or ON, the address of the variable SLOT is also printed. 

GOTO READ. AGAIN 

Branches to the label READ. AGAIN elsewhere in the LPL program. 

FIND D5 AA 96 

Causes a search from the current CURSOR pointer until the END pointer, 

searching for the string D5 AA 96. 

FIND PAT4 

This is the same as the previous example, except that the search is for 
the contents of the string variable PAT4. If a processing routine accepts 
a string variable, it also accepts an explicitly coded string. 

ERROR '5' 

This causes the character '5' to be placed in the current track of the 

status display area. 

PAT4 D4 DD FF 
PATS D5 AA 96 
CHANGE PAT4 PATS 

This processing routine changes all occurrences of the first string to the 
secund for the entire range of START to END. Note that the CHANGE 
statement and other statements that accept two strings as parameters do 
not accept multiple byte constants. For example, the following use of the 
CHANGE statement is invalid: 
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CHANGE D5 AA 96 PAT4 
CHANGE PAT4 D5 AA 96 
CHANGE D5 AA B4 TQ D5 AA 96 

COPY 22 1 (invokes track procedure) 
FCOPY O 22 (Fast Disk Backup copy) 

ERASE 

This causes the track to be erased on the output dr i ve. 

FORWARD TRK.LEN 

BACK TRK.LEN 

These statements cause the CURSOR to be moved forward or bacl-ward by the 

length determined by the variable TRK.LEN. These routines can also be 

coded with a 2-byte constant . For example: 

FORWARD 024E 

BACK 0042 

CODE AD CUR.TRK 0A OA OA OA 60 

The CODE process i ng rout i ne is provi ded -for the 6502 assembl y language 
programmer. The parameters supplied are decoded, placed in a contiguous 
area of memory , and given control with a JSR instructi on. 

PRT "ASCII TEXT TO PRINT" 

The "PRT" routine prints data on the display screen. If the last byte of 

the string is a blank, no new line is started. In this way, you can 

display te:;t with the value of a variable name . For example: 

PRT "TRACK INCREMENT IS " : SHOW INCR.TRK 

Some processing routines function slightly differently depending on 
whether in "nibble-made" or i n "byte-mode" . If the last read or wr i te 
command was NREAD or NWRITE, then nibble-mode is in effect. If the last 
read or write command was SREAD, SWRITE, TREAD or TWRITE, then byte-mode 

is in effect. 

The routines which function differently depending on whether in nibble 
nude or byte mode are FIND, VER, and CHANGE. 

In nibble mode, a :ero value in the pattern specified acts as a "don't 
care" value. It can be coded as ei t her "*?" or "0" . 

In byte mode (used when readi ng or wr i ting sectors), the zero value in a 
pattern is significant. 

For e::ampl e: 

NREAD : FIND D5 00 96 

The above statement* perform a nibble-read of the current trad, and place 
the CURSOR on the f i rst occurrence of a DS value, f ol lowed by an/ value, 
followed by a 96 value. 

The statement s: 

TREAD : FIND D5 00 96 
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The above example performs a trad-read o-f the current tract:, and places 
the CURSOR on the -first occurrence of a D5, followed by a 00, followed by 
a 96. 

In byte-mode, "don't care" values in pattern search strings are not 
all owed . 

The fallowing processing routines accept either string variables or 

multiple byte constants: 

FIND 

VER 

REP 

DEPOSIT 

The nibble or byte mode can be changed manually by setting the flag 
variable BYTE. MODE to YES if byte mode is desired, or to NO if nibble mode 
i s desi red . 
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TRACK-PROCEDURES 

A track procedure is a sequence of LPL statements that are to be executed 
for each tract that is being copied. (One may consider the entire LPL 
file as a disk procedure, because it is involved with processing the 
entire disk to be copied.) The track procedure is defined with the 
BEGIN. PROC and END.PROC statements. The track procedure is then later 
invoked for each track to be copied, by a processing routine which invokes 
the track procedure. There is currently only one routine which invokes 
the current track procedure. The COPY processing routine (either 
nibble-copy or sector-copy) invokes the current track procedure. The 
"current" track procedure is the last one which was defined. If no track 
procedure was defined in the LPL file, then the default Locksmith track 
procedure is used. 

For example: 

BEGIN. PROC 

... track procedure A 

END.PROC 

COPY S 2 
COPY 12 18 2 

BEGIN. PROC 

... track procedure B 

END.PROC 

COPY 1 9 2 
COPY 13 19 2 

In the above example, the first two COPY processing routines will use 
track procedure A, and the second two COPY routines will use track- 
procedure B. 

The LPL statements within the track procedure can be used to process a 
track in one of two modes. Either in nibble-mode or sector-mode. 
Nibble-mode processing routines are NREAD, NWRITE, NVERIFY, which process 
a tract in the form of nibbles. Sector-mode processing routines are 
TREAD, TWRITE, TVERIFY, which process a track in the form of 16 separate 
sectors. 

The format of the COPY command is: 

COPY :begin.trk> <end.trk> <incr.trk> 

where <begin.trk> is the starting track, <end.trk> ii the anding trad, 
and -'incr.trl > is the track increment. These values are stored in tha 
variable names BEGIN. TRK, END.TRK, and INCR.TRK, respectively. 

If tracks are to be synchronized or nibble-count preservation is to be 
performed, set the variable names SYNC or COUNT to the value YES. The 
SYNC and COUNT keywords are not specified on the COPY command, as in 
version 5.0 of Locksmith. 
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LPL ERROR COOES 



During execution of the LPL program, some errors may be encountered which 
cannot be checked for during syntax check of the LPL statements. 

If an error is encountered during execution of LPL code, processing 
immediately stops and the following message is displayed on the screen: 

LPL CODE ABORTED 

ERROR CODE xx 

where "x x " is one of the foil owi ng values: 

01 GOTO statement encountered without finding the matching LABEL 
statement . 

02 PROC. BEGIN statement encountered while already within a track 
procedure. 

03 PROC. END statement encountered while already outside of a track 
procedure. 

04 COPY statement encountered within a track procedure. The COPY 
Btat ement i nvokes a track procedure and cannot occur within one. 

05 USE. DEFAULT. PROC encountered while within a track procedure. 
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NIBBLE DECODE TABLE 



00: A A 


AA 


20: BA 


AA 


40: AA 


EA 


60: BA 


EA 


80: EA 


AA 


AO:FA 


AA 


COiEA 


EA 


EOi 


FA 


EA 


OllAA 


AB 


21:BA 


AB 


41 lAA 


EB 


61:BA 


EB 


81:EA 


AB 


A1:FA 


AB 


C1:EA 


EB 


Eli 


FA 


EB 


02lAB 


AA 


22: BB 


AA 


42: AB 


EA 


62: BB 


EA 


82: EB 


AA 


A2:FB 


AA 


C2:EB 


EA 


E2: 


FB 


EA 


03iAB 


AB 


23: BB 


AB 


43: AB 


EB 


63: BB 


EB 


83:EB 


AB 


A3:FB 


AB 


C3:EB 


EB 


E3 


FB 


EB 


04lAA 


AE 


24: BA 


AE 


44:AA 


EE 


64: BA 


EE 


84:EA 


AF 


A4:FA 


AE 


C4:EA 


EE 


E4i 


FA 


EE 


OSlAA 


AF 


25: BA 


AF 


45: A A 


EF 


65: BA 


EF 


8S1EA 


AF 


AS: FA 


AF 


C5:EA 


EF 


E5 


FA 


EF 


06:AB 


AE 


26: BB 


AE 


46: AB 


EE 


66: BB 


EE 


86: EB 


AE 


A6:FB 


AE 


C6:EB 


EE 


E6 


FB 


EE 


07lAB 


AF 


27:BB 


AF 


47:AB 


EF 


67:BB 


EF 


87: EB 


AF 


A7:FB 


AF 


C7:EB 


EF 


E7 


FB 


EF 


08: AE 


AA 


28: BE 


AA 


48: AE 


EA 


68: BE 


EA 


88: EE 


AA 


A8:FE 


AA 


C8-.EE 


EA 


EB 


FE 


EA 


09:AE 


AB 


29: BE 


AB 


49: AE 


EB 


69: BE 


EB 


89:EE 


AB 


A9:FE 


AB 


C9:EE 


EB 


E9 


FE 


EB 


0A:AF 


AA 


2A:BF 


AA 


4A:AF 


EA 


6A:BF 


EA 


8A:EF 


AA 


AA:FF 


AA 


CA:EF 


EA 


EA 


FF 


Eft 


OB: AF 


AB 


2B:BF 


AB 


4B:AF 


EB 


6B:BF 


EB 


8B:EF 


AB 


AB:FF 


AB 


CB:EF 


EB 


EB 


FF 


EB 


OClAE 


AE 


2C:BE 


AE 


4C:AE 


EE 


6C:BE 


EE 


8C:EE 


AE 


AC:FE 


AE 


CC:EE 


EE 


EC 


FE 


EE 


0D:AE 


AF 


2D: BE 


AF 


4D:AE 


EF 


6D:BE 


EF 


BD:EE 


AF 


AD:FE 


AF 


CD:EE 


EF 


ED 


FE 


EF 


OElAF 


AE 


2E:BF 


AE 


4E:AF 


EE 


6E:BF 


EE 


8E>EE 


AF 


AE:FF 


AE 


CE:EF 


EE 


EE 


FF 


EE 


0F:AF 


AF 


2F:BF 


AF 


4F:AF 


EF 


6F:BF 


EF 


8F:EF 


AF 


AF:FF 


AF 


CF:EF 


EF 


EF 


FF 


EF 


IOiAA 


BA 


30: BA 


BA 


SO:AA 


FA 


70: BA 


FA 


90: EA 


BA 


BO: FA 


BA 


DO:EA 


FA 


FO 


FA 


FA 


11 :AA 


BB 


31:BA 


BB 


51: AA 


FB 


71:BA 


FB 


91:EA 


BB 


B1:FA 


BB 


D1:EA 


FB 


Fl 


FA 


FB 


12:AB 


BA 


32: BB 


BA 


52: AB 


FA 


72: BB 


FA 


92: EB 


BA 


B2:FB 


BA 


D2-.EB 


FA 


F2 


FB 


FA 


13:AB 


BB 


33: BB 


BA 


53:AB 


FB 


73: BB 


FB 


93: EB 


BB 


B3:FB 


BB 


D3:EB 


FB 


F3 


FB 


FB 


14: A A 


BE 


34: BA 


BE 


S4:AA 


FE 


74: BA 


FE 


94:EA 


BE 


B4:FA 


BE 


D4:EA 


FE 


F4 


FA 


FE 


15: AA 


BF 


35: BA 


BF 


55: AA 


FF 


75: BA 


FF 


95: EA 


BF 


B5:FA 


BF 


D5:EA 


FF 


F5 


FA 


FF 


16:AB 


BE 


36: BB 


BE 


56: AB 


FE 


76: BB 


FE 


96: EB 


BE 


B6:FB 


BE 


D6:EB 


FE 


F6 


FB 


FE 


17iAB 


BF 


37:BB 


BF 


57:AB 


FF 


77: BB 


FF 


97:EB 


BF 


B7:FB 


BF 


D7:EB 


FF 


F7 


FB 


FF 


1B:AE 


BA 


38: BE 


BA 


58: AE 


FA 


78: BE 


FA 


98: EE 


BA 


B8:FE 


BA 


D8:EE 


FA 


F8 


FE 


FA 


19:AE 


BB 


39: BE 


BB 


59:AE 


FB 


79: BE 


FB 


99: EE 


BB 


B9:FE 


BB 


D9:EE 


FB 


F9 


FE 


FB 


1A-.AF 


BA 


3A:BF 


BA 


SA:AF 


FA 


7A:BF 


FA 


9A:EF 


BA 


BA:FF 


BA 


DA:EF 


FA 


FA 


FF 


FA 


IB: AF 


BB 


3B:BF 


BB 


SB:AF 


FB 


7B:BF 


FB 


9B:EF 


BB 


BB:FF 


BB 


DB:EF 


FB 


FB 


FF 


FB 


1C:AE 


BE 


3C:BE 


BE 


5C:AE 


FE 


7C:BE 


FE 


9C:EE 


BE 


BC:FE 


BE 


DC:EE 


FE 


FC 


FE 


FE 


1D:AE 


BF 


3D: BE 


BF 


5D:AE 


FF 


7D:BE 


FF 


9D:EE 


BF 


BD:FE 


BF 


DD:EE 


FF 


FD 


FE 


FF 


IEiAF 


BE 


3E:BF 


BE 


5E:AF 


FE 


7E:BF 


FE 


9E:EF 


BE 


BE:FF 


BE 


DE:EF 


FE 


FE 


FF 


FE 


1F:AF 


BF 


3F:BF 


BF 


5F:AF 


FF 


7F:BF 


FF 


9F:EF 


BF 


BF:FF 


BF 


DF:EF 


FF 


FF 


FF 


FF 



TRACK NUMBER DECODE TABLE 

00:AA AA 01:AA AB 02:AB AA 03:AB AB 04:AA AE 05:AA AF 06:AB AE 07:AB AF 

08: AE AA 09: AE AB OA:AF AA OB:AF AB OClAE AE 0D:AE AF 0E:AF AE OF:AF AF 

10:AA BA 11:AA BB 12:AB BA 13:AB BB 14:AA BE 1S:AA BF 16:AB BE 17:AB BF 

18:AE BA 19:AE BB 1A:AF BA 1B:AF BB 1C:AE BE 1D:AE BF 1E:AF BE 1F:AF BF 
20: BA AA 21:BA AB 22: BB AA 23: BB AB 
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SECTOR NUMBER DECODE TABLE 

NIBBLES VALUE NIBBLES VALUE 



AA AA 


00 


AE AA 


08 


AA AB 


01 


AE AB 


09 


AB AA 


02 


AF AA 


OA 


AB AB 


03 


AF AB 


OB 


AA AE 


04 


AE AE 


OC 


AA AF 


05 


AE AF 


OD 


AB AE 


06 


AF AE 


OE 


AB AF 


07 


AF AF 


OF 



DATTA FIELD M I BBLE ENCODING TABLE 

The -following tranaUtt table is used for calculating data field 
checksums. It is described in the chapter on the dimk editor describing 
the * D' command. 



00: 


96 


01: 


97 


02: 


9A 


03: 


9B 


04 i 


9D 


05: 


9E 


06 1 


9F 


07i 


A6 


OB: 


A7 


09: 


AB 


OA: 


AC 


OB: 


AD 


OC: 


AE 


OD: 


AF 


OEl 


B2 


OF: 


B3 


10: 


B4 


11: 


B5 


12: 


B6 


13: 


B7 


14: 


B9 


15: 


BA 


16: 


BB 


17. 


BC 


18: 


BD 


19: 


BE 


1A: 


BF 


IB; 


CB 


1C: 


CD 


ID: 


CE 


IE: 


CF 


IF: 


D3 


20: 


;D6 


21. 


D7 


22; 


;D9 


23. 


;DA 


24: 


;DB 


25: 


DC 


26; 


;DD 


27. 


DE 


28; 


:DF 


29; 


iE3 


2A; 


lE6 


2B: 


;E7 


2Ci 


;E9 


2D: 


;EA 


2E; 


:EB 


2F: 


; EC 


30; 


lED 


31; 


:EE 


32 


:EF 


33 


:F2 


34; 


:F3 


35; 


;F4 


36 


:F5 


37; 


:F6 


38; 


:F7 


39; 


:F9 


3A 


:FA 


3B; 


;FB 


3C: 


:FC 


3D; 


;FD 


3Ei 


iFE 


3F; 


IFF 
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PHYSICAL TO LOGICAL TRANSLATION TABLET 

The fictor numbers contained in the address fields o-f a 16 sector 
-formatted diskette appear in ascending order (»0 to «F ) on successive 
sectors. These physical sector numbers Arm converted by the disk 
operating system to logical sector numbers, to allow for faster read/write 
of multiple sectors. The following table shows the relationship between 
physi cal sector number and 1 ogi cal sector number . 

PHYSICAL LOGICAL 









1 


7 


2 


E 


3 


6 


4 


D 


5 


5 


6 


c 


7 


4 


8 


B 


9 


3 


A 


A 


B 


2 


C 


9 


D 


1 


E 


8 


F 


F 
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TRACK LAYOUTS < 1 3 mrtct 16 as sect or- > 



There have been two different track foraata In common usa for tha Appla 
II. Ona of thaa racordad 13 uctori on itch of tha 33 tracks. Tha othar, 
by ••ploying a more afficiant data packing algorltha and slightly modified 
hardware, 1* capabla of racordlng 16 uctori par track. 

Both formats *rm basically tha saaa, with tha exception of tha nathod of 
packing tha data flald. In addition, tha addrass flald haadar Is slightly 
diffarant to allow tha two diffarant foraats to ba idantlflad aasily. 

Slnca tha 13 sactor format Is no longar In common usa, Ma will discuss tha 
16 sactor format, and Mill idantify Mhara tha two formats diffar. 

Tha track Is racordad Mlth 16 (or 13) sactors, each consisting of an 
addrass flald and a data fiald. Tha addrass flald contains information 
about tha data flald which immadlataly folloMs It. Tha flalda ara 
saparatad by gaps, which contain 'salf-sync' nibblas. These sslf-sync 
nibblas ara spacially racordad nibblas which causa tha disk controllar 
hardwara to synchronize, so that tha fiald following tha salf-sync can ba 
read. 

Tha addrass and data flalda aach contain a haadar, Information nibblas, 
and a trallar. 

Tha addrass fiald contains haadar nibblas of DS AA 96 (or DS AA B3, If 13 
sactor), followad by 4 t tarns of Information, ancodad in double-nibble 
format. Two consacutiva nibblas Arm usad to raprasant tha voluma numbar, 
track numbar, sactor numbar, and checksum. Tha chackaum is simply an 
axclusiva-or of tha othar 3 ltams of information. A tabla is includad in 
this manual to allow you to convart thasa doubl a-nl bbl as to tha valuas 
thay raprasant. Following thasa 4 itama of information, is tha addrass 
fiald trallar, which consists of OE AA. 

After a gap of self-sync nibblas, tha data fiald appears. Tha data fiald 
consists of a header, D3 AA AD, followad by 342 nibbles (or 410, if 13 
sector foraat) which represent the actual sactor data. Thasa nibblas *rm 
encoded using a 6-bit tabla shown In tha appendix section of this manual 
titled "Data Field Nibble Encoding". (If 13 sactor format, a 5-bit table 
la usad.) After tha data nibbles, a single nibble Is provided for 
checksum, followad immediately by tha data fiald trailer, DC AA. 

In soma early protection schemes, tha header and trailer nibbles in tha 
address and data flalda ware changed to soma othar value. (sae "History 
of Locksmith and Copy Protection" chapter of this manual) 
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Attention Apple //gs Users: 

The current version of Locksmith 6.0 (revision level D) will work properly 
with any version of Apple // computer, including the Apple //gs. 
However, the Fast Disk Backup IF" from main menu) recognizes only 64K 
of the 256K (or more) of the //gs memory. If you are going to be using 
your Locksmith on an Apple //gs, we suggest that you apply a patch which 
is supplied on the included library diskette. 

The patch, which is named "tPATCH FDB I1GS 256 , patches your Locksmith 
Fast Disk Backup to assume that it is running on an Apple //gs, and will 
use 256K of auxiliary memory to perform one-pass backup copies. 

Apply this patch only if you are using your Locksmith on an Apple //gs, as 
after this patch is applied, Fast Disk Backup will not work properly on 
machines other than an Apple //gs. And. of course, you should only patch 
a copy of your Locksmith diskette, keeping the original in a safe place 

To patch your Locksmith diskette: 

1 . Boot your Locksmith disk. 

2. Press "T" to enter the text editor. 

3. Press "N", then "B" (backup/copy disk) 

4. Remove Locksmith disk and insert library disk, then press space bar. 

5. Press down-arrow key (or control-J) until "IPATCH FDB IIGS 256" is 
highlighted, then press return. 

6. Remove the library disk and insert the Locksmith disk, (make sure 
that the write-protect tab is removed) 

7. Press the space bar. 

8. Press return key twice. 

9. Press space bar. 

10. Press return key. 'PATCH APPLIED SUCCESSFULLY" should appear. 

11. Remove Locksmith diskette, cover the write-protect notch. Your 
Locksmith disk is now updated. 

12. To use the updated version of Locksmith, you must reboot Locksmith. 

Note that when running Fast Disk Backup, the display incorrectly shows 
that 64K auxmem is being used (28 tracks per pass). Actually, 256K will 
he used (for 35 tracks per pass - one pass copies.) 



Also included on the library disk are other tPATCH files, including one 
named $PATCH TXT ED DR2" which will set the default library disk drive 
to drive two for U9ers with two drive systems. 
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